Pop up menu

version 6.0

Pop up menu (contenu{; parDéfaut}) Numérique

Paramètre	Type		Description
contenu	Texte		Définition du texte du menu
parDéfaut	Numérique		Numéro de l'élément sélectionné par défaut
Résultat	Numérique		Numéro de l'élément de menu sélectionné

La commande Pop up menu fait apparaître un pop up à l'emplacement courant du curseur de la souris.

Selon les règles standard d'interface utilisateur, cette commande doit généralement être appelée en réponse à un clic souris, et lorsque le bouton reste enfoncé un certain laps de temps.

Vous définissez les éléments du pop up menu à l'aide du paramètre contenu, de la manière suivante :

• Chaque élément est séparé des autres par un point-virgule (;), "Elément1;Elément2;Elément3".

• Pour inactiver un élément, placez une parenthèse ouvrante "(" dans son libellé.

• Pour définir une ligne de séparation, passez la valeur "(-" en tant que libellé.

• Pour définir le style de caractères d'un élément, placez dans son libellé le symbole inférieur à "<" suivi d'une lettre. Voici les différents codes :

	<B	Gras
	<I	Italique
	<U	Souligné
	<O	Contours (MacOS seulement)
	<S	Relief (MacOS seulement)

• Pour associer une coche à un élément, insérez dans son libellé un point d'exclamation "!" suivi du caractère que vous voulez utiliser comme coche. Sous MacOS, le caractère est affiché ; sous Windows, une coche standard est affichée (quel que soit le caractère passé).

• Pour associer une icône à un élément, insérez dans son libellé un accent circonflexe "^" suivi d'un caractère dont le code ASCII moins 48 plus 256 (ou plus 208) représente un numéro de ressource d'icône MacOS.

• Pour ajouter un raccourci clavier à un élément, insérez dans son libellé une barre oblique "/" suivie du caractère de raccourci. Notez que cette dernière option est uniquement informative (aucun raccourci clavier n'active le pop up menu), cependant vous pouvez indiquer un raccourci clavier si l'élément du pop up menu dispose d'une commande équivalente dans la barre de menus principale de votre application.

Le paramètre optionnel parDéfaut vous permet de définir l'élément du pop up menu sélectionné par défaut lorsque celui-ci apparaît. Passez une valeur située entre 1 et le nombre d'éléments du menu. Si vous ne passez pas ce paramètre, le premier élément du menu sera sélectionné par défaut.

Lorsqu'un élément du pop up menu est sélectionné, la commande retourne son numéro, autrement elle retourne zéro.

Note : Utilisez les pop up menus avec un nombre "raisonnable" d'éléments. Si, par exemple, vous voulez afficher plus de 50 éléments, envisagez plutôt d'employer une zone de défilement dans un formulaire.

La méthode projet MON RACCOURCI fait apparaître un pop up menu de navigation :

      ` Méthode projet MON RACCOURCI
   POSITION SOURIS($vlMouseX;$vlMouseY;$vlBouton)
   Si (Macintosh control enfoncee | ($vlBouton=2))
      $vtItems:="A propos de cette base...<I;(-;!-Autres options;(-"
      Boucle ($vlTable;1;Nombre de tables)
         $vtItems:=$vtItems+";"+Nom de la table($vlTable)
      Fin de boucle 
      $vlChoixUtilisateur:=Pop up menu($vtItems)
      Au cas ou 
         : ($vlChoixUtilisateur=1)
            ` Afficher les informations
         : ($vlChoixUtilisateur=2)
            ` Afficher les options
         Sinon 
            Si ($vlChoixUtilisateur>0)
               ` Aller à la table dont le numéro est $vlChoixUtilisateur-4
            Fin de si 
      Fin de cas 
   Fin de si 

Cette méthode projet peut être appelée d'une des manières suivantes :

• depuis la méthode d'un objet réagissant à un clic souris, et n'attendant pas que le bouton soit relâché (par exemple un bouton invisible),

• depuis un process qui "épie" les événements et communique avec les autres process,

• depuis une méthode de gestion d'événements installée par la commande APPELER SUR EVENEMENT.

Dans les deux derniers cas, il n'est pas nécessaire que le clic se produise dans un objet de formulaire. C'est l'un des avantages de la commande Pop up menu. Généralement, les pop up menus sont affichés par l'intermédiaire d'objets de formulaire. Avec Pop up menu, vous pouvez faire apparaître un pop up menu n'importe où.

Le pop up menu s'affiche sous Windows lorsque l'utilisateur appuie sur le bouton droit de la souris, et sous MacOS lorsqu'il utilise la combinaison Control+clic. Notez cependant que la méthode ci-dessus ne teste pas le clic souris, c'est la méthode appelante qui en est chargée.

Voici le pop up menu tel qu'il s'affiche sous Windows (à gauche) et sous MacOS (à droite). Notez la coche standard de la version Windows :

POSITION SOURIS.