Programming with Reflection

image\rwnprg32.gif OpenSettingsExtended method

 

Syntax object.OpenSettingsExtended FileName, [Type], [Options]

 

Description

Opens a settings file or activates a group of settings from a settings file.

For example, this statement opens the specified Reflection for UNIX and OpenVMS settings file, without making a connection:

Session.OpenSettingsExtended "C:\Mypath\Myset.r2w", rcSettings, rcNoConnect

Arguments

Filename Argument Type: String
Required
Specifies the path and filename for the settings file. Supply complete path information if the file isn't on the Reflection macro path.

Type Argument Type: Enumeration
Optional
Identifies what settings to open. If this argument is omitted, the default is rcSettings. Use only one constant value for this argument. You cannot add two values. Only rcSettings changes all existing settings. If you use one of the other options, all existing settings remain unchanged except those specified. The possible values are:

 rcSettings

 Opens a complete settings file. This activates all of the settings in the file.

 rcColors

 Activates just the color settings in the file, and ignores all other settings.

 rcConnection

 Activates just the connection settings in the file, and ignores all other settings.

 rcHotspots

 Activates just the hotspot settings in the file, and ignores all other settings.

 rcKeymap

 Activates just the keymap (keyboard and mouse map) settings in the file, and ignores all other settings.

 rcMenuMap

 Activates just the menu settings in the file, and ignores all other settings.

 rcToolbar

 Activates just the toolbar settings in the file, and ignores all other settings.

Options Argument Type: Enumeration
Optional
This argument has an effect only if you are opening a complete or partial settings file that configures a connection. If this argument is omitted, Reflection will automatically make the connection. Use the following value for this argument if you want to open the settings file without making the connection.

 rcNoConnect

 Opens the specified settings file without making a connection.

 

image\jump.gif Example

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command