4D Doc Center : SET MENU ITEM

Home

4D v14.3

SET MENU ITEM


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

Parameter	Type	Description
menu	Longint, MenuRef	Menu number or Menu reference
menuItem	Longint	Menu item number or -1 for the last item added
itemText	String	New text for the menu item
process	Longint	Process reference number
*	Operator	If 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.