Menu De l’application

Le menu Application est le menu main d’une application qui implémente l’infrastructure du ruban Windows.

• Introduction
• Composants du menu Application
  • Menu d’application MenuGroup
• Dimensionnement du menu Application
• Propriétés du menu de l’application
• Rubriques connexes

Introduction

Le menu Application est composé d’un contrôle de bouton déroulant qui affiche un menu contenant des commandes qui exposent des fonctionnalités liées à un projet complet, comme un document, une image ou un film entier. Les commandes New, Open, Save et Exit en sont des exemples.

La capture d’écran suivante illustre le menu Application.

Composants du menu Application

Le menu Application est un élément obligatoire dans toute application ruban. Le point d’entrée dans le menu Application est un bouton distinctif qui apparaît en tant que premier élément de la ligne Tab , comme illustré dans la capture d’écran suivante.

Notes

Windows 8 et versions ultérieures : l’image du bouton Du menu de l’application a été remplacée par l’étiquette : Fichier. Nous vous recommandons de ne pas utiliser Fichier comme étiquette pour vos propres onglets.

 

Lorsque vous cliquez sur ce bouton, ce bouton affiche le menu enrichi qui apparaît dans la capture d’écran suivante (le menu Application de WordPad pour Windows 7).

Notes

Il n’y a aucun impact sur l’onglet défini lorsque l’utilisateur clique sur le bouton Menu de l’application ; au lieu de cela, le focus entre dans le menu.

 

Le menu Application contient deux volets : une liste de commandes représentée par un ou plusieurs éléments MenuGroup et une liste Éléments récents représentée par un élément ApplicationMenu.RecentItems .

Menu d’application MenuGroup

L’élément ApplicationMenu doit contenir au moins un élément enfant MenuGroup qui expose une liste de commandes au niveau de l’application. Si plusieurs éléments MenuGroup sont déclarés, une ligne de séparation est dessinée entre les groupes, comme illustré dans la capture d’écran suivante.

Voici une liste de contraintes pour un élément MenuGroup d’un menu Application :

• Tous les éléments MenuGroup doivent être déclarés avec la valeur d’attribut Class .MajorItems

• Un menuGroup de menu d’application prend uniquement en charge les contrôles Button, Drop-Down Button, Split Button, Drop-Down Gallery et Split Button Gallery .

  ![Important]
  Les galeries de commandes sont le seul type de galerie pris en charge dans le menu Application. Pour plus d’informations sur les contrôles de galerie, consultez Utilisation des galeries.

   

Lorsqu’un Button est utilisé dans un MenuGroup, la valeur de Command.LabelTitle s’affiche dans le menu et les valeurs de Command.TooltipTitle et Command.TooltipDescription sont affichées en tant qu’info-bulle, comme indiqué dans la capture d’écran suivante.

Lorsqu’un bouton déroulant, un bouton fractionner, une galerie de listes déroulantes ou une galerie de boutons fractionnés est utilisé dans le menu Application, la partie du menu s’affiche sous la forme d’un menu volant qui couvre et masque le volet Éléments récents .

Pour les contrôles Bouton fractionné et Bouton déroulant , la valeur de Command.LabelDescription est affichée en ligne dans le menu volant pour aider visuellement les utilisateurs à découvrir la fonctionnalité De commande. La valeur affichée de Command.LabelDescription est divisée par programmation sur une étendue de deux lignes, et une tentative est effectuée pour ajuster la valeur exactement sur le volet Éléments récents en dessous. Si la valeur Command.LabelDescription ne correspond pas, le menu volant se développe pour prendre en charge la valeur Command.Comment la plus longue dans le MenuGroup.

La capture d’écran suivante illustre ces comportements dans un menu volant Split Button .

Avec une galerie déroulante et une galerie de boutons fractionnés, seules une étiquette et une image sont affichées.

Dimensionnement du menu Application

Le dimensionnement du menu application est géré par l’infrastructure du ruban. Si des chaînes très longues sont fournies pour la valeur de Command.LabelTitle ou Command.LabelDescription, ou si une longue liste de commandes est utilisée, le menu ajuste sa taille pour s’adapter au contenu. Certaines formes d’ajustement incluent l’augmentation de la taille des menus volants ou des volets de menu, et l’ajout de visionneuses panoramiques lorsque le défilement est nécessaire.

Propriétés du menu de l’application

L’infrastructure du ruban définit une collection de clés de propriété pour le contrôle Menu Application.

En règle générale, une propriété Menu Application est mise à jour dans l’interface utilisateur du ruban en invalidant la commande associée au contrôle par un appel à la méthode IUIFramework::InvalidateUICommand . L’événement d’invalidation est géré et les mises à jour des propriétés sont définies par la méthode de rappel IUICommandHandler::UpdateProperty .

La méthode de rappel IUICommandHandler::UpdateProperty n’est pas exécutée et l’application n’est pas interrogée pour une valeur de propriété mise à jour tant que la propriété n’est pas requise par le framework. Par exemple, l’infrastructure nécessite la propriété lorsqu’un onglet est activé et qu’un contrôle est révélé dans l’interface utilisateur du ruban, ou lorsqu’une info-bulle est affichée.

Clé de propriété	Notes
UI_PKEY_TooltipDescription	Peut être mis à jour uniquement par invalidation.
UI_PKEY_TooltipTitle	Peut être mis à jour uniquement par invalidation.

 

Rubriques connexes

Bibliothèque de contrôles de l’infrastructure du ruban Windows

Élément de balisage ApplicationMenu