AJOUTER LIGNE MENU

4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant

version 6.0


AJOUTER LIGNE MENU (menu; libelléLigne{; process})

ParamètreTypeDescription
menuNumériqueNuméro de menu
libelléLigneAlphaLibellé du ou des nouvelle(s) ligne(s) de menu
processNumériqueNuméro de référence du process

Description

La commande AJOUTER LIGNE MENU ajoute une ou plusieurs ligne(s) de menu au menu dont vous avez passé le numéro 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.

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 :

<BGras
<IItalique
<USouligné
<OContours (Mac OS seulement)
<SRelief (Mac OS seulement)

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 ASCII 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.

Note : AJOUTER LIGNE MENU accepte un texte comportant jusqu'à 32 000 caractères alors que INSERER LIGNE MENU n'en accepte que 255.

Important : Les nouvelles lignes ne sont pas associées à des méthodes. Elles doivent donc être gérées par une méthode formulaire, à l'aide de la commande 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

INSERER LIGNE MENU, SUPPRIMER LIGNE MENU.


4D - Documentation   Français   English   German   4e Dimension, Commandes par thèmes   4e Dimension, Liste alphabétique des commandes   4e Dimension, Constantes par thèmes   Retour   Précédent   Suivant