Commandes de menu (C++)

Les informations ci-dessous sont organisées en fonction des propriétés de menu qui apparaissent dans la fenêtre Propriétés lorsque vous sélectionnez une commande de menu. Celles-ci sont répertoriées par ordre alphabétique, bien que la fenêtre Propriétés vous permet également d’afficher ces propriétés par catégorie.

Propriété	Description
Break	Peut prendre l'une des valeurs suivantes : - Aucun : Pas de pause. Il s’agit de la valeur par défaut. - Colonne: pour les menus statiques, cette valeur permet de placer la commande de menu sur une nouvelle ligne. Pour les menus contextuels, cette valeur permet de placer la commande de menu dans une nouvelle colonne sans ligne de démarcation entre les colonnes. Cette propriété affecte l'apparence du menu uniquement au moment de l'exécution, pas dans l'éditeur de menus. - Barre : identique à la colonne, à l’exception des menus contextuels, cette valeur sépare la nouvelle colonne de l’ancienne colonne par une ligne verticale. La définition de cette propriété affecte l’apparence du menu uniquement au moment de l’exécution, et non dans l’Éditeur de menu.
Caption	Texte qui indique la commande de menu (nom du menu). Pour que l'une des lettres de la légende d'une commande de menu devienne une touche mnémonique, faites-la précéder d'une esperluette (&).
Activée	Si la valeur est True, la commande de menu est initialement case activée ed. Type : Bool. Valeur par défaut : False.
Activé	Si la valeur est False, l'élément de menu est désactivé.
Grisé	Si la valeur est True, la commande de menu est initialement grisée et inactive. Type : Bool. Valeur par défaut : False.
Aide	Aligne l'élément de menu à droite. Valeur par défaut : False. Par exemple, la commande de menu ? (Aide) est toujours sur la droite dans toutes les applications Windows. Si vous affectez cette propriété à un élément de menu, celui-ci s'affiche à l'extrémité droite et à la fin du menu. S'applique aux éléments de niveau supérieur.
Identifiant	Symbole défini dans le fichier d'en-tête. Type : symbole, entier ou chaîne entre guillemets. Vous pouvez utiliser n'importe quel symbole couramment disponible dans les éditeurs, même si la fenêtre Propriétés ne fournit pas de liste déroulante pour sélectionner des éléments.
Popup	Si la valeur est True, la commande de menu est un menu contextuel. Type : Bool. Valeur par défaut : True pour les menus de niveau supérieur dans une barre de menus, sinon False.
Demander	Contient le texte qui s'affiche dans la barre d'état quand cette commande de menu est mise en surbrillance. Le texte est placé dans la table de chaînes avec le même identificateur que la commande de menu. Cette propriété est disponible pour tous les types de projet, mais les fonctionnalités d'exécution sont spécifiques à MFC.
Justification de droite à gauche	Aligne à droite la commande de menu dans la barre de menus au moment de l'exécution. Type : Bool. Valeur par défaut : False.
Ordre de droite à gauche	Permet d'afficher les commandes de menu de droite à gauche quand l'interface est localisée dans une langue qui se lit de droite à gauche, par exemple l'hébreu ou l'arabe.
Separator	Si la valeur est True, la commande de menu est un séparateur. Type : Bool. Valeur par défaut : False.

Associer des commandes de menu

Bien souvent, vous souhaitez qu’une commande de menu et une combinaison de touches du clavier exécutent la même commande de programme. Les commandes identiques sont émises à l’aide de l’Éditeur de menu pour affecter le même identificateur de ressource à la commande de menu et à une entrée dans la table accélérateur de votre application. Ensuite, vous modifiez la Légende de la commande de menu pour afficher le nom de la touche accélérateur.

Pour associer une commande de menu à une touche accélérateur

1. Dans l’Éditeur de menu, sélectionnez la commande de menu souhaitée.

2. Dans la fenêtre Propriétés, ajoutez le nom de la touche accélérateur à la propriété Légende :

   • À la suite de la légende de menu, tapez la séquence d’échappement d’une tabulation (\t) pour que toutes les touches accélérateurs du menu soient alignées à gauche.

   • Tapez le nom de la touche modificateur (Ctrl, Alt ou Maj) suivi d’un signe plus (+) et du nom, de la lettre ou du symbole de la touche supplémentaire.

   Par exemple, pour affecter Ctrl+O à la commande Ouvrir dans le menu Fichier, vous modifiez la légende de la commande de menu pour qu’elle ressemble au texte suivant :

   &Open...\tCtrl+O
   

   La commande de menu de l’Éditeur de menu est mise à jour pour refléter la nouvelle légende lorsque vous tapez-la.

3. Créez l’entrée de table d’accélérateurs dans l’éditeur d’ accélérateurs et attribuez-lui le même identificateur que la commande de menu. Utilisez une combinaison de touches facile à mémoriser.

Votre application MFC peut afficher un texte descriptif pour chacune des commandes de menu qu’un utilisateur peut sélectionner. Affichez du texte descriptif en affectant une chaîne de texte à chaque commande de menu à l’aide de la propriété Prompt dans la fenêtre Propriétés . Si vous avez une chaîne dans la table de chaînes dont l'ID est identique à la commande, une application MFC affiche automatiquement cette ressource de chaîne dans la barre d'état de l'application en cours d'exécution quand un utilisateur pointe sur un élément de menu.

• Pour associer une commande de menu à une chaîne de texte de barre d’état dans les applications MFC, dans l’Éditeur de menu, sélectionnez la commande de menu. Dans la fenêtre Propriétés, tapez le texte de barre d'état associé dans la zone Invite .

Dans un projet C++, vous pouvez affecter une touche d’accès (un mnémonique qui permet à l’utilisateur de sélectionner le menu avec le clavier) à vos menus et commandes de menu.

• Pour affecter une touche d’accès (raccourci) à une commande de menu, tapez un ampersand (&) devant une lettre dans le nom du menu ou le nom de commande pour spécifier cette lettre comme clé d’accès correspondante.

  Par exemple, « &File » définit Alt+F comme touche de raccourci pour le menu Fichier dans les applications écrites pour Microsoft Windows.

  L’élément de menu fournit un indice visuel signalant qu’une touche de raccourci est affectée à l’une de lettres. La lettre qui suit que le symbole & apparaît soulignée (en fonction du système d’exploitation).

Remarque

Vérifiez que toutes les touches d’accès d’un menu sont uniques en cliquant avec le bouton droit sur votre menu et en choisissant Vérifier les mnémoniques.

Spécifications

Win32

Voir aussi

Éditeur de menus