Programming with Reflection

image\rwnprg32.gif SetCommandGroupProfile method

 

Syntax object.SetCommandGroupProfile CmdGroup, IsEnabled

 

Description

Specifies whether a given Reflection feature or group of commands is enabled (executable) or disabled (not executable). A call to this method will fail if the specified feature or command group has been locked by a call to the LockProfile method.

For example, the following statement disables all file transfers:

Session.SetCommandGroupProfile rcFileTransfer, rcDisabled

Arguments

CmdGroup Argument Type: Enumeration
Required
Identifies the group of commands to enable or disable. The possible values are:

 rcSecondInstance

 Determines whether or not you can run more than one simultaneous copy of Reflection.

 rcStartScreen

 Determines whether or not Reflection displays a picture at startup.

 rcUntitled

 Determines whether or not you can open untitled Reflection sessions. When this feature is disabled, you must open Reflection using a settings file.

 rcUnencryptedConnections

 Determines whether or not you can make connections to hosts using unencrypted protocols.

 rc<terminal type>

 Determines whether Reflection supports the specified terminal. Click here for a list of constants for disabling and enabling specific terminals.

 rcSetup

 Setup commands. This option affects all controls in the Setup dialog boxes. Note: Disabling these items removes them from the Reflection Setup menu.

 rcFullColorSetup

 (Reflection for HP only) Disable this to restrict an end user's ability to change color attributes other than Normal and Halfbright in the Display Setup dialog box (these two settings remain available). All other color attributes take their settings automatically from choices made for these two settings.

 rcFileTransfer

 Disables all file transfer operations and commands. Using this value disables the file transfer buttons in the File Transfer dialog box, and returns an error if file transfer is initiated programmatically.

 rcFileTransferReceive

 Disables file transfers to the local PC. Using this value disables the button in the File Transfer dialog box that initiates file transfer to the local PC, and returns an error if file transfer is initiated programmatically.

 rcFileTransferSend

 Disables file transfers to the host. Using this value disables the button in the File Transfer dialog box that initiates file transfer to the host, and returns an error if file transfer is initiated programmatically.

 rcTracing

 Affects access to tracing operations and commands. This value affects Tracing commands on Reflection menus, tracing in Reflection macros, and tracing done programmatically from external applications using Automation.

 rcHostDirectory

 Specifies whether a host folder listing can be displayed in the File Transfer dialog box.

 rcSavePasswords

 Specifies whether passwords are saved with your host connection or connect macro. This affects the LAT connections, and passwords that are saved in macros. When this value is disabled, the SavePasswords property cannot be set to True.

 rcMenus

 Affects all menu commands that are part of Reflection's default menus (including the context menu that appears when you right-click). Commands that are part of the default menus are affected even if you have moved or renamed (or both) the menu items. Custom menu items added using the Menu Setup dialog box are not affected. Note: Disabled menu items are removed from Reflection.

 rcMenuConversion

 Affects whether Reflection merges new menu items into your customized and saved menus when you upgrade to a newer version of Reflection.

 rcVBA

 Affects whether Reflection can execute macros and Visual Basic commands. Note: Disabled menu items are removed from Reflection.

 rcVBALocal

 Affects access to the Visual Basic Editor and the command line. When this feature is disabled, users cannot create or edit macros, but Reflection can still run login macros or use Visual Basic commands or macros that have been linked to keystrokes, toolbars, events, menus, or hotspots. Note: Disabled menu items are removed from Reflection.

 rcCmdLineCommands

 Disables use of the following switches on Reflection's startup command line: /RBS, /RB, /RCL, /RCLS, /VBA.

 rcOLEAutomation

 Affects access to commands that control Reflection's methods and properties through Automation.

 rcRB

 Affects access to all Reflection Basic commands (host-initiated and locally-initiated).

 rcRBHost

 Affects access to Reflection Basic or RCL commands executed from the host (but not commands executed locally).

 rcRBLocal

 Affects access to any Visual Basic command and any Reflection Basic commands executed locally (but not from the host).

 rcRCL

 Affects access to RCL commands (both host-initiated and locally initiated).

 rcRCLHost

 Affects access to RCL commands executed remotely from the host (but not commands executed locally).

 rcRCLLocal

 Affects access to RCL commands executed locally (but not commands executed remotely from the host).

 rcDDEServer

 Affects access to Reflection via DDE.

 rcCustomRloginUserName

 Normally, users can customize the user name used for an RLogin connection. When this feature is disabled, RLogin will always use the Windows login name when establishing a connection.

 rcVTUTF8

 Affects access to VT-UTF8 emulation.

IsEnabled Argument Type: Enumeration
Required
Specifies whether the given command group is enabled or disabled. The possible values are:

 rcEnabled

 The command group is enabled.

 rcDisabled

 The command group is disabled.

 

image\jump.gif Keyword Index

image\popup.gif Related Topics

image\popup.gif Reflection products that use this command