Get menu bar reference

4D v20 R7


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

Paramètre	Type	Description
process	Entier long	Numéro de référence du process
Résultat	RefMenu	Identifiant de la barre de menus

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