4D Doc Center : Pop up menu dynamique

4D v14.3

Pop up menu dynamique


Pop up menu dynamique ( menu {; parDéfaut {; coordX ; coordY}} ) -> Résultat

Paramètre	Type	Description
menu	RefMenu	Référence de menu
parDéfaut	Chaîne	Paramètre de l'élément sélectionné par défaut
coordX	Entier long	Coordonnée X du coin supérieur gauche
coordY	Entier long	Coordonnée Y du coin supérieur gauche
Résultat	Chaîne	Paramètre 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 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 la chaîne personnalisée associée à l’élément de menu. Cette chaîne doit avoir été préalablement définie à l’aide de la commande FIXER PARAMETRE 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 chaîne de caractères personnalisée associée (telle que définie à l’aide de la commande FIXER PARAMETRE 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.