4D v16.3

SET MENU ITEM

Home

 
4D v16.3
SET MENU ITEM

SET MENU ITEM 


 

SET MENU ITEM ( menu ; menuItem ; itemText {; process}{; *} ) 
Parameter Type   Description
menu  Longint, MenuRef in Menu number or Menu reference
menuItem  Longint in Menu item number or -1 for the last item added
itemText  String in New text for the menu item
process  Longint in Process reference number
Operator in If passed: consider metacharacters as standard characters

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 

Product: 4D
Theme: Menus
Number: 348

Not for server

 
HISTORY 

Modified: 4D v11 SQL Release 4

 
ARTICLE USAGE

4D Language Reference ( 4D v16)
4D Language Reference ( 4D v16.1)
4D Language Reference ( 4D v16.2)
4D Language Reference ( 4D v16.3)