4D v13.4
SET MENU ITEM ICON
- 4D Language Reference
-
- Menus
-
- Managing Menus
- APPEND MENU ITEM
- Count menu items
- Count menus
- Create menu
- DELETE MENU ITEM
- DISABLE MENU ITEM
- Dynamic pop up menu
- ENABLE MENU ITEM
- Get menu bar reference
- Get menu item
- GET MENU ITEM ICON
- Get menu item key
- Get menu item mark
- Get menu item method
- Get menu item modifiers
- Get menu item parameter
- GET MENU ITEM PROPERTY
- Get menu item style
- GET MENU ITEMS
- Get menu title
- Get selected menu item parameter
- INSERT MENU ITEM
- Menu selected
- RELEASE MENU
- SET MENU BAR
- SET MENU ITEM
- SET MENU ITEM ICON
- SET MENU ITEM MARK
- SET MENU ITEM METHOD
- SET MENU ITEM PARAMETER
- SET MENU ITEM PROPERTY
- SET MENU ITEM SHORTCUT
- SET MENU ITEM STYLE
SET MENU ITEM ICON
| SET MENU ITEM ICON ( menu ; menuItem ; iconRef {; process} ) | ||||||||
| Parameter | Type | Description | ||||||
| menu | Longint, MenuRef |
|
Menu reference or Menu number | |||||
| menuItem | Longint |
|
Number of menu item or -1 for the last item added to the menu | |||||
| iconRef | Text, Longint |
|
Name or number of picture to be associated with menu item | |||||
| process | Longint |
|
Process number | |||||
The SET MENU ITEM ICON command modifies the icon associated with the menu item designated by the menu and menuItem parameters.
You can pass -1 in menuItem in order to specify the last item added to menu.
In menu, you can pass a menu reference (MenuRef) or a menu number. If you pass a menu reference, the command will apply to all the instances of the menu in all the processes. In this case, the process parameter is ignored if it is passed. If you pass a menu number, the command will take the corresponding menu in the main menu bar of the current process into account. If you want to designate another process, pass its number in the optional process parameter.
In iconRef, you can pass the picture to be used as the icon. You can use a library picture or a picture reference.
- Library picture: You can pass either the name or number of the picture. It is generally preferable to use its number rather than its name since picture numbers are unique IDs, which is not the case with names.
- Picture reference: The picture must be located in the Resources folder of the database and you must use a "file:{pathname}fileName" type syntax in iconRef. For more information about the Resources folder, refer to the Current date section.
Use of a picture located in the Resources folder of the database:
SET MENU ITEM ICON($MenuRef;2;"File:English.lproj/spot.png")
Product: 4D
Theme: Menus
Number:
984
Created: 4D v11 SQL
