Programming with Reflection

image\rwnprg32.gif SiteDefaults property



object.SiteDefaults = Value

Works with


Data type




Returns (first syntax line) or specifies (second syntax line) the name of a settings file that is used to determine the default values for new instances of Reflection. This string can contain drive and path information.

If this property is set to an empty string (or if it has been set to a string that does not correspond to a valid settings file), new Reflection sessions use factory defaults for all settings except those that are saved in the registry. If this property is set to the name of a Reflection settings file, new Reflection sessions will use the settings in the specified file. For example, this command specifies that all new instances of Reflection for UNIX and OpenVMS will use the settings that are saved to the "My Settings" file:

Session.SiteDefaults = "C:\Mypath\My Settings.r2w"

The specified string can identify a complete or a partial settings file, but if you specify a partial settings file, it must be one you created using the same Reflection application. This means a Colors settings file created for Reflection for HP cannot be the site default file for Reflection for UNIX and OpenVMS. The following example sets site defaults for the toolbar configuration contained in the "Toolbar.rtb" file:

Session.SiteDefaults = "C:\Mypath\Toolbar.rtb"

When a site defaults settings file has been specified, you can view items that have been changed from the site defaults using the second option in the Display Settings area of the View Settings dialog box.


The default value is "".


image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this property