SET MENU ITEM ICON
SET MENU ITEM ICON ( menu ; ligneMenu ; refIcône {; process} )
| Paramètre | Type | Description | |
|---|---|---|---|
| menu | Integer, Text | → | Référence de menu ou Numéro de menu |
| ligneMenu | Integer | → | Numéro de ligne de menu ou -1 pour la dernière ligne ajoutée au menu |
| refIcône | Text, Integer | → | Nom ou numéro de l’image à associer à la ligne de menu |
| process | Integer | → | Numéro de process |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande SET MENU ITEM ICON permet de modifier l’icône associée à la ligne de menu désignée par les paramètres menu et ligneMenu.
Vous pouvez passer dans menu un identifiant unique de menu (RefMenu) ou un numéro de menu. Si vous passez un identifiant unique, la commande s’appliquera à toutes les instances du menu dans tous les process. Dans ce cas, le paramètre process est ignoré s’il est passé. Si vous passez un numéro de menu, la commande prendra en compte le menu correspondant dans la barre de menus principale du process courant. Si vous souhaitez désigner un autre process, passez son numéro dans le paramètre facultatif process.
Vous pouvez passer -1 dans ligneMenu afin de désigner la dernière ligne ajoutée au menu.
Passez dans le paramètre refIcône l'image devant être utilisée comme icône. Vous pouvez utiliser une référence de fichier image ou (base de données binaires uniquement) une image issue de la bibliothèque.
- Référence de fichier image. Deux syntaxes sont prises en charge :
- path:
(recommandé), par exemple "path:/RESOURCES/icon.png". Pour plus d'informations, reportez-vous au pragraphe Chemins des filesystem. - file:
(obsolète), par exemple "file:icon.png". L'image doit se trouver dans le dossier Resources de la base.
- path:
- Image de la bibliothèque (bases de données binaires uniquement) : vous pouvez passer soit le nom soit le numéro de l' image. Il est généralement préférable d’utiliser le numéro plutôt que le nom, car les numéros d’images sont des identifiants uniques, ce qui n’est pas le cas des noms.
Note : Il est recomandé d'utiliser des chemins vers des fichiers image, étant donné que la bibliothèque d'images est obsolète et n'est plus supportée dans les projets 4D. De plus, la syntaxe file:
Exemple
Utilisation d'une image se trouvant dans le dossier Resources de la base :
SET MENU ITEM ICON($RefMenu;2;"Path:/RESOURCES/french.lproj/spot.png")