version 11 (Modifiée)
AJOUTER LIGNE MENU (menu; libelléLigne{; sousMenu{; process}})
Paramètre | Type | Description | |
menu | Num | RefMenu | Numéro de menu ou Référence de menu | |
libelléLigne | Texte | Libellé du ou des nouvelle(s) ligne(s) de menu | |
sousMenu | RefMenu | Référence du sous-menu associé à la ligne | |
process | Numérique | Numéro de référence du process |
Description
La commande AJOUTER LIGNE MENU ajoute une ou plusieurs ligne(s) au menu dont vous avez passé le numéro ou la référence dans menu.
Si vous omettez le paramètre process, AJOUTER LIGNE MENU s'applique à la barre de menus du process courant. Sinon, AJOUTER LIGNE MENU s'applique à la barre de menus du process dont vous avez passé le numéro dans process.
Note : Si vous passez un paramètre RefMenu dans menu, le paramètre process est inutile et sera ignoré.
AJOUTER LIGNE MENU vous permet d'ajouter une ou plusieurs lignes de menu en un seul appel.
Vous définissez les lignes à ajouter à l'aide du paramètre libelléLigne, de la manière suivante :
Chaque ligne est séparée des autres par un point-virgule ";", "ligne1;ligne2;ligne3".
Pour inactiver une ligne, 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'une ligne, placez dans son libellé le symbole inférieur à "<" suivi d'une lettre. Voici les différents codes :
<B | Gras | |
<I | Italique | |
<U | Souligné |
Pour associer une coche à une ligne, insérez dans son libellé un point d'exclamation "!" suivi du caractère que vous voulez utiliser comme coche. Sous Mac OS, 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 à une ligne, insérez dans son libellé un accent circonflexe "^" suivi d'un caractère dont le code moins 48 plus 256 (ou plus 208) représente un numéro de ressource d'icône Mac OS.
Pour ajouter un raccourci clavier à une ligne, insérez dans son libellé une barre oblique "/" suivie du caractère de raccourci.
Note : Utilisez les menus avec un nombre "raisonnable" de lignes. Si, par exemple, vous voulez afficher plus de 50 lignes, envisagez plutôt d'employer une zone de défilement dans un formulaire.
Le paramètre facultatif sousMenu vous permet de désigner un menu comme ligne ajoutée et donc de définir un sous-menu hiérarchique. Vous devez passer dans ce paramètre une référence de menu (chaîne de type RefMenu) désignant un menu créé par exemple à l'aide de la commande Creer menu. Si la commande ajoute plusieurs lignes de menus, le sous-menu est associé à la première ligne.
Important : Les nouvelles lignes n'ont pas de méthodes ou d'actions associées. Vous devez leur associer une action ou une méthode via les commandes FIXER PROPRIETE LIGNE MENU ou FIXER METHODE LIGNE MENU ou encore les gérer à partir d'une méthode formulaire qui utilise la fonction Menu choisi.
Exemple
L'exemple suivant ajoute les noms des polices de caractères disponibles dans un menu Polices qui, dans cet exemple, est le sixième menu de la barre de menus courante :
` Dans la méthode base Sur ouverture ` La liste des polices est chargée et les libellés construits LISTE DES POLICES(<>asPolicesDispo) <>atPoliceCmdMenus:="" Boucle ($vlPolice;1;Taille tableau(<>asPolicesDispo)) <>atPoliceCmdMenus:=<>atPoliceCmdMenus+";"+<>asPolicesDispo{$vlPolice} Fin de boucle
Ensuite, dans toute méthode formulaire ou projet, vous pouvez écrire :
AJOUTER LIGNE MENU(6;<>atPoliceCmdMenus)
Référence
FIXER REFERENCE LIGNE MENU, INSERER LIGNE MENU, SUPPRIMER LIGNE MENU.