GET MENU ITEM ICON
GET 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 associée à 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 GET MENU ITEM ICON retourne dans la variable refIcône la référence de l’icône éventuellement associée à la ligne de menu désignée par les paramètres menu et ligneMenu. Cette référence est le chemin d'accès ou le numéro de l’image.
Vous pouvez passer -1 dans ligneMenu afin de désigner la dernière ligne ajoutée au menu.
Vous pouvez passer dans menu un identifiant unique de menu (RefMenu) ou un numéro de menu. Si vous passez un identifiant unique, le paramètre process est inutile et sera 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.
- Si l'icône a été définie à l'aide d'un fichier image, la commande retourne dans refIcône le chemin d'accès via la syntaxe path:
. - Si l'icône a été définie à l'aide d'une image issue de la bibliothèque (base de données binaires uniquement), la commande retourne soit le numéro soit le nom de l'image, en fonction du type de variable passé dans ce paramètre. La syntaxe suivante est utilisée pour un nom : pictlib:
.
Si vous n’attribuez pas de type spécifique à la variable refIcône, par défaut le nom de l’image est retourné (type texte).
Si aucune icône n’est associée à la ligne, la commande retourne une valeur vide.