GET MENU ITEM PROPERTY
GET MENU ITEM PROPERTY ( menu ; ligneMenu ; propriété ; valeur {; process} )
| Paramètre | Type | Description | |
|---|---|---|---|
| menu | Integer | → | 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 |
| propriété | Text | → | Type de propriété |
| valeur | any | ← | Valeur de la propriété |
| 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 PROPERTY retourne dans le paramètre valeur la valeur courante de la propriété de la ligne de menu désignée par les paramètres menu et ligneMenu.
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.
Passez dans le paramètre propriété la propriété dont vous souhaitez obtenir la valeur. Vous pouvez utiliser l’une des constantes du thème “Propriétés des lignes de menu” ou une chaîne correspondant à une propriété personnalisée. Pour plus d’informations sur les propriétés des menus et leurs valeurs, reportez-vous à la description de la commande SET MENU ITEM PROPERTY.
Note de compatibilité : Par défaut, si la variable valeur n'est pas typée explicitement ou est déclarée de type texte, la commande retournera un nom d'Action standard. Si vous souhaitez obtenir une valeur numérique comme défini dans le thème de constantes (obsolète) Valeurs pour Actions standard associée, vous devez déclarer la variable valeur de type entier long.