Get menu bar reference
Get menu bar reference {( process )} : Text
| Paramètre | Type | Description | |
|---|---|---|---|
| process | Integer | → | Numéro de référence du process |
| Résultat | Text | ← | Identifiant de la barre de menus |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande Get menu bar reference renvoie l’identifiant unique de la barre de menus courante ou de la barre de menus d’un process spécifique.
Si la barre de menus a été créée par la commande Create menu, cet identifiant correspond à la référence unique du menu créé. Sinon, la commande retourne un identifiant interne spécifique(*). Dans tous les cas, cet identifiant RefMenu pourra être utilisé pour référencer la barre de menus par toutes les autres commandes du thème.
(*) Cet identifiant spécifique est temporaire et devient invalide dès qu'une autre barre de menus est appelée avec SET MENU BAR. Si vous voulez conserver la référence d'un menu créé dans l'éditeur de menus, vous devez la copier en mémoire à l'aide de Create menu. Par exemple :
$vEditorRef:=Get menu bar reference(Frontmost process) //menu créé dans l'éditeur de menus
$vMenuRef:=Create menu($vEditorRef) //copier le menu en mémoire
SET MENU BAR(2) //installer une autre barre de menus
... // exécuter code
SET MENU BAR($vMenuRef) //retour à la barre de menus d'origine
Le paramètre process permet de désigner le process duquel vous souhaitez obtenir l’identifiant de la barre de menus courante. Si vous omettez ce paramètre, la commande retourne l’identifiant de la barre de menus du process courant.
Exemple
Reportez-vous à l'exemple de la commande GET MENU ITEMS.