GET MENU ITEM ICON

4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next

version 11


GET MENU ITEM ICON (menu; menuItem; iconRef{; process})

ParameterTypeDescription
menuMenuRef | NumMenu reference or Menu number
menuItemNumberNumber of menu item or
-1 for the last item added to the menu
iconRefText var | Longint varName or number of picture
associated with menu item
processNumberProcess number

Description

The GET MENU ITEM ICON command returns, in the iconRef variable, the reference of any icon that is associated with the menu item designated by the menu and menuItem parameters. This reference is the name or number of the picture.

The icon associated with a menu item is added to the tool bar of the application.

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 process parameter is unnecessary and will be 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.

If the icon has been specified using a library picture, the command returns either the name or number of the picture depending on the type of variable passed in this parameter. If the icon has been specified using a picture stored in the Resources folder of the database, the command returns the picture pathname in iconRef.

If you do not attribute a specific type to the iconRef variable, by default, the name of the picture is returned (text type).

If no icon is associated with the menu item, the command returns a blank value.

See Also

SET MENU ITEM ICON.


4D - Documentation   Français   English   German   Spanish   4D v11 SQL, Command Theme List   4D v11 SQL, Command Alphabetical List   4D v11 SQL, Constant Theme List   Back   Previous   Next