Skip to main content
Version: Next

SET MENU ITEM

SET MENU ITEM ( menu ; menuItem ; itemText {; process}{; *} )

ParameterTypeDescription
menuInteger, TextMenu number or Menu reference
menuItemIntegerMenu item number or -1 for the last item added
itemTextTextNew text for the menu item
processIntegerProcess reference number
*OperatorIf passed: consider metacharacters as standard characters

Description

The SET MENU ITEM command changes the text of the menu item whose menu number or reference is passed in menu and whose item number is passed in menuItem, to the text passed in itemText. You can pass -1 in menuItem in order to designate the last item added to the menu.

If you do not pass the * parameter, any "special" characters included in itemText (such as ( ; or !) will be considered as instruction characters (metacharacters). For example, to set a menu item as a separator line, you insert the “-” character into itemText. If you pass the * parameter, the "special" characters will be considered as standard characters. Please refer to the description of the APPEND MENU ITEM command for more details about these characters.

If you omit the process parameter, SET MENU ITEM applies to the menu bar for the current process. Otherwise, SET MENU ITEM applies to the menu bar for the process whose reference number is passed in process.

Note: If you pass a MenuRef in menu, the process parameter serves no purpose and will be ignored.

See also

APPEND MENU ITEM
Get menu item
SET MENU ITEM SHORTCUT

Properties

Command number348
Thread safe
Forbidden on the server