Aller au contenu principal
Version: Next

Get menu bar reference

Get menu bar reference {( process )} -> Résultat

ParamètreTypeDescription
processIntegerNuméro de référence du process
RésultatTextIdentifiant 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.

Voir aussi

SET MENU BAR