Specifies the conditions under which a menu item will be enabled or disabled.
Scope: File
Syntax
set group.[MenuItemId] [GroupName] [GroupName] [...]
Options
MenuItemId |
The numeric menu item id that can be obtained by the query actionbarid command. The id for the last-defined menu item is used, if zero or no value is specified. |
GroupName |
The name of the group to which the MenuItemId is
added. Unrecognized group names are ignored. One or more
of the following groups can be specified: BLOCK CHANGED ClassName CLIPBOARD DOCNONEMPTY MARKSET MOREDOCS MOREVIEWS SAVEABLE WRITEABLE |
Description
The group parameter specifies the group(s) to which a menu item belongs. The conditions for each associated group must be satisfied before a menu item is enabled.
For example, the Paste operation belongs to the CLIPBOARD and WRITEABLE groups. It will be enabled only when there is text in the clipboard and the file is not readonly.
The following table lists the states required for each group to be active or inactive:
Group Name Active
Members are SelectableInactive
Members are not Selectable BLOCKBlock is set Block is not set CHANGEDChange has been made No changes have been made ClassNameOther classes are included in the current view Only a specified class is included in the current view CLIPBOARDClipboard contains text Clipboard is empty DOCNONEMPTYFile contains text File is empty MARKSETMark is set No mark is set MOREDOCSMore than one file is open Only one file is open MOREVIEWSMore than one view is open Only one view is open SAVEABLEFile can be saved File cannot be saved WRITEABLEChanges to file permitted Changes to file not permitted
Examples
set group.block
set group.comments
API Return Code
-3 |
The specified menu item id does not correspond to any user-defined action. |
![]()
