SET MENU ITEM
SET MENU ITEM ( menu ; menuItem ; itemText {; process}{; *} )
| Parameter | Type | Description | |
|---|---|---|---|
| menu | Integer, Text | → | Menu number or Menu reference |
| menuItem | Integer | → | Menu item number or -1 for the last item added |
| itemText | Text | → | New text for the menu item |
| process | Integer | → | Process reference number |
| * | Operator | → | If passed: consider metacharacters as standard characters |
This command is not thread-safe, it cannot be used in preemptive code.
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.