Create menu
Create menu {( menu )} : Text
| Paramètre | Type | Description | |
|---|---|---|---|
| menu | Text, Integer, Text | → | Référence de menu ou Numéro ou Nom de barre de menus |
| Résultat | Text | ← | Référence du menu |
Cette commande n'est pas thread-safe, elle ne peut pas être utilisée dans du code préemptif.
Description
La commande Create menu permet de créer un nouveau menu en mémoire. Ce menu n’existera qu’en mémoire et ne sera pas ajouté dans l’éditeur de menus en mode Développement. Toute modification effectuée sur ce menu durant la session sera immédiatement répercutée à l’ensemble des instances de ce menu et ce, dans tous les process de la base.
La commande retourne un identifiant unique de type RefMenu pour le nouveau menu.
- Si vous ne passez pas le paramètre facultatif menu, le menu sera créé vide. Vous devrez le construire et le gérer à l’aide des commandes RELEASE MENU, SET MENU ITEM, etc.
- Si vous passez le paramètre menu, le menu créé sera une copie exacte du menu source désigné par ce paramètre. Toutes les propriétés du menu source, y compris les éventuels sous-menus associés, seront appliquées au nouveau menu. A noter qu’une nouvelle référence RefMenu est créée pour le menu source et pour chaque sous-menu associé existant.
Vous pouvez passer dans menu soit une référence de menu valide, soit un numéro ou un nom de barre de menus défini en mode Développement. Dans ce dernier cas, le nouveau menu sera constitué des menus et sous-menus de la barre d’origine.
Note : Si vous passez une valeur invalide dans menu, un menu vide est créé.
Un menu créé par cette commande peut être utilisé en tant que barre de menus à l’aide de la commande SET MENU BAR.
Lorsque vous n'avez plus besoin d'un menu créé par Create menu, n'oubliez pas d'appeler la commande RELEASE MENU afin de libérer la mémoire qu'il occupe.
Exemple
Reportez-vous à l'exemple de la commande SET MENU BAR.