menuactive Parameter

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.

menucheck Parameter