version 11
Pop up menu dynamique (menu{; parDéfaut{; coordX{; coordY}}}) RefLigne
Paramètre | Type | Description | |
menu | RefMenu | Référence de menu | |
parDéfaut | RefLigne | Référence de l'élément sélectionné par défaut | |
coordX | Numérique | Coordonnée X du coin supérieur gauche | |
coordY | Numérique | Coordonnée Y du coin supérieur gauche | |
Résultat | RefLigne | Référence de l'élément de menu sélectionné |
Description
La commande Pop up menu dynamique fait apparaître un pop up menu hiérarchique à l'emplacement courant de la souris ou à l'emplacement défini par les paramètres facultatifs coordX et coordY.
Le menu hiérarchique utilisé doit avoir été créé à l'aide de la nouvelle commande Creer menu. La référence retournée par Creer menu doit être passée dans le paramètre menu.
Conformément aux règles standard d'interface, cette commande doit généralement être appelée en réponse à un clic droit, ou lorsque le bouton reste enfoncé un certain laps de temps (menu contextuel par exemple).
Le paramètre facultatif parDéfaut vous permet de définir un élément du pop up menu sélectionné par défaut lorsque celui-ci apparaît. Passez dans ce paramètre une référence d'élément de menu. Cette référence doit avoir été préalablement définie à l'aide de la nouvelle commande FIXER REFERENCE LIGNE MENU. Si vous ne passez pas ce paramètre, le premier élément du menu sera sélectionné par défaut.
Les paramètres facultatifs coordX et coordY permettent de désigner l'emplacement du pop up menu à afficher. Passez respectivement dans coordX et coordY les coordonnées horizontale et verticale du coin supérieur gauche du menu. Ces coordonnées doivent être exprimées en pixels dans le système de coordonnées local au formulaire courant. Ces deux paramètres doivent être passés ensemble ; si un seul est passé, il est ignoré.
Si vous souhaitez afficher un pop up associé à un bouton 3D, il suffit de ne pas passer les paramètres facultatifs coordX et coordY. Dans ce cas, 4D calcule automatiquement l'emplacement du menu par rapport au bouton en fonction des normes d'interface de la plate-forme courante.
Si une ligne de menu a été sélectionnée, la commande retourne sa référence (telle que définie à l'aide de la nouvelle commande FIXER REFERENCE LIGNE MENU). Sinon, la commande retourne une chaîne vide.
Note : La commande Pop up menu (thème "Interface utilisateur") permet de créer des pop up menus basés sur du texte.
Référence
FIXER REFERENCE LIGNE MENU, Lire reference ligne menu, Lire reference ligne menu selectionnee, Pop up menu.