Enables or disables a menu bar item, pull-down menu choice, or pop-up menu item in the Editor window.
| Note: | This parameter is valid only in an Editor window. |
Scope: View
Syntax
set menuactive.Name { on | off | inverse }
query menuactive.Name
Options
Name |
Either the predefined Editor window name for an Editor-defined menu item, or a numeric value for a user-added item. The numeric value can be obtained by querying the actionbarid parameter. |
on |
Enables the menu bar item or menu choice. |
off |
Disables the menu bar item or menu choice. |
inverse |
Toggle between on and off. |
Description
The menuactive parameter enables or disables menu bar items or sub -menus. The action is performed on the window for the current file view. Disabling an item does not disable any accelerator key; this must be done using an appropriate set action command. Similarly, enabling an item does not activate the accelerator key.
The following list defines the names of the predefined Editor items and the English content of each item:
| Menu ID | Description or Name | Menu ID | Description or Name | ||
|---|---|---|---|---|---|
| LP_SYSMENU | System menu | LP_TOOLBAR_HELP | Hover help | ||
| LP_FILE | File | LP_TOOLBAR_STYLE | Style | ||
| LP_NEW | New... | LP_TOOLBAR_BOTH | Graphic and text | ||
| LP_OPENEDIT | Open... | LP_TOOLBAR_GRAPHIC | Graphic only | ||
| LP_NEWVIEW | Open new view | LP_TOOLBAR_TEXT | Text Only | ||
| LP_GET | Get... | LP_RING | Ring | ||
| LP_SAVE | Save | LP_RINGSINGLE | Single window | ||
| LP_SAVEAS | Save as... | LP_RINGNEW | New ring | ||
| LP_SAVEALL | Save all | LP_RINGEXPLODE | All new rings | ||
| LP_CLOSEVIEW | Close view | LP_RINGSPLIT | Split ring | ||
| LP_CLOSERING | Close ring | LP_RINGCONFIGURE | Configure rings... | ||
| LP_PRINT | Print... | LP_RINGDEFAULT | Default to ring | ||
| LP_COLLAPSE | Minimize all | LP_RINGSELECTOR | Ring selector | ||
| LP_CLOSE | Exit | LP_SPLIT | Split orientation | ||
| LP_EDIT | Edit | LP_VERTICAL | Vertical | ||
| LP_UNDO | Undo | LP_HORIZONTAL | Horizontal | ||
| LP_REDO | Redo | LP_WRAP | Wrap | ||
| LP_CLIPCUT | Cut | LP_VIEWSPLIT | Split window | ||
| LP_CLIPCOPY | Copy | LP_ACTIONS | Actions | ||
| LP_CLIPPASTE | Paste | LP_ISSUECMD | Issue edit command... | ||
| LP_FINDCHANGE | Find... | LP_COMPARE | Compare... | ||
| LP_FINDNEXT | Find next | LP_RECORD | Keystroke recorder | ||
| LP_FINDPREV | Find up | LP_RECSTART | Start/Restart | ||
| LP_FINDSEL | Find selection | LP_RECHALT | Halt | ||
| LP_SELALL | Select all | LP_RECPLAY | Playback | ||
| LP_DESELALL | Deselect all | LP_RECCONT | Continue recording | ||
| LP_BLOCK | Block | LP_RECRENAME | Rename macro... | ||
| LP_MARKLINE | Mark line | LP_RECDELETE | Delete all macro lines | ||
| LP_MARKCHAR | Mark character | LP_OPTIONS | Options | ||
| LP_MARKRECT | Mark rectangle | LP_PARAMETERS | Editor parameters... | ||
| LP_UNMARK | Unmark | LP_FONTS | Font... | ||
| LP_COPY | Copy | LP_COLORS | Color Palette... | ||
| LP_OVERLAY | Overlay | LP_TOKENS | Token attributes... | ||
| LP_MOVE | Move | LP_GLOBALS | Global variables... | ||
| LP_DELETE | Delete | LP_PROFS | Profiles | ||
| LP_UPPER | Uppercase | LP_CHANGEPROFS | Change profiles... | ||
| LP_LOWER | Lowercase | LP_ACTIVEPROFS | All active | ||
| LP_LOCATE | Locate | LP_KEYS | Key behavior | ||
| LP_NEXTERROR | Next error | LP_LPEXKEYS | LPEX | ||
| LP_LINE | Line... | LP_EPMKEYS | EPM | ||
| LP_START | Start of block | LP_SEUKEYS | SEU | ||
| LP_END | End of block | LP_XEDITKEYS | XEDIT | ||
| LP_JUMP | Previous location | LP_ISPFKEYS | ISPF | ||
| LP_QUICKMARK | Quick mark | LP_CUSTOMIZE | Customize... | ||
| LP_FINDMARK | Mark... | LP_SAVEKEYS | Save key behavior | ||
| LP_SETQUICK | Set quick mark | LP_WINDOWS | Windows | ||
| LP_NAMEMARK | Name a mark... | LP_MACROLOG | Macro log | ||
| LP_VIEW | View | LP_DOCLIST | File list | ||
| LP_FILTER | Filter... | LP_NEXTINRING | Next in ring | ||
| LP_FILTERDATE | Filter date... | LP_PREVINRING | Previous in ring | ||
| LP_SHOWALL | Show all | LP_NEXTRING | Next ring | ||
| LP_FORMATLINE | Format line | LP_PREVRING | Previous in ring | ||
| LP_MSGLINE | Message line | LP_HELP | Help | ||
| LP_STATUSLINE | Status line | LP_HOWDOI | How do I... | ||
| LP_TOOLBAR | Tool bar | LP_ABOUT | Product information | ||
| LP_TOOLBAR_SHOW | Show | ||||
| Note: | Based on the state of the Editor, some built-in menu items are automatically enabled or disabled. They are not affected by the value of the menuactive parameter setting. |
Example
To suspend the Keystoke recorder choices in the Actions menu, type:
set menuactive.LP_RECORD off
API Return Code
-2 |
The option specified with the parameter was not valid. Check the syntax requirements for the parameter and try the set or query command again. |
![]()
