Élément de menuMenu Element

Définit un élément de menu.Defines one menu item. Voici les six types de menus : contexte, un Menu, MenuController, MenuControllerLatched, barre d’outils et ToolWindowToolbar.These are the six kinds of menus: Context, Menu, MenuController, MenuControllerLatched, Toolbar, and ToolWindowToolbar.

SyntaxeSyntax

<Menu guid="guidMyCommandSet" id="MyCommand" priority="0x100" type="button">  
  <Parent>... </Parent>  
  <CommandFlag>... </CommandFlag>  
  <Strings>... </Strings>  
</Menu>  

Attributs et élémentsAttributes and Elements

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.The following sections describe attributes, child elements, and parent elements.

AttributsAttributes

AttributAttribute DescriptionDescription
GUIDguid Obligatoire.Required. GUID de l’identificateur de commande/ID GUID.GUID of the GUID/ID command identifier.
IDid Obligatoire.Required. ID de l’identificateur de commande/ID GUID.ID of the GUID/ID command identifier.
prioritypriority Facultatif.Optional. Valeur numérique qui spécifie la position relative d’un menu dans un groupe de menus.A numeric value that specifies the relative position of a menu in a group of menus.
ToolbarPriorityInBandToolbarPriorityInBand Facultatif.Optional. Valeur numérique qui spécifie la position relative d’une barre d’outils dans une bande lorsque la fenêtre est ancrée.A numeric value that specifies the relative position of a toolbar in a band when the window is docked.
typetype Facultatif.Optional. Valeur énumérée qui spécifie le type d’élément.An enumerated value that specifies the kind of element.

Cas d’absence, le type par défaut est de Menu.If not present, the default type is Menu.

ContexteContext
Un menu contextuel qui s’affiche lorsqu’un utilisateur clique sur une fenêtre.A shortcut menu that is shown when a user right-clicks a window. Un menu contextuel présente les caractéristiques suivantes :A shortcut menu has the following characteristics:

-N’utilisez pas les champs Parent et priorité quand le menu à afficher sous forme de menu contextuel.- Does not use the Parent and Priority fields when the menu is to be displayed as a shortcut menu.
-Peut être utilisé comme un sous-menu et cela joue également un menu contextuel.- Can be used as a submenu and also as a shortcut menu. Dans ce cas, les champs ID de groupe et de priorité sont respectées.In this case, both Group ID and Priority fields are respected.
-N’est pas toujours disponible.- Is not always available.

Un menu contextuel s’affiche uniquement lorsque les conditions suivantes sont remplies :A shortcut menu is displayed only when the following conditions are true:

-La fenêtre qui héberge ce dernier s’affiche.- The window that hosts it is displayed.
: Un gestionnaire de souris dans le package Visual Studio détecte un clic droit sur la fenêtre, puis appelle une méthode qui gère la commande.- A mouse handler in the VSPackage detects a right-click on the window and then calls a method that handles the command.
-Le menu contextuel s’affiche en appelant le ShowContextMenu (méthode) (recommandé) ou ShowContextMenu (méthode).- The shortcut menu is displayed by calling the ShowContextMenu method (the recommended approach) or the ShowContextMenu method.

MenuMenu
Fournit un menu déroulant.Provides a drop-down menu. Un menu déroulant présente les caractéristiques suivantes :A drop-down menu has the following characteristics:

-Respecte le Parent dans sa définition.- Respects the Parent in its definition.
-Doit avoir un groupe Parent, ou un CommandPlacement à un groupe.- Must have a Parent group, or a CommandPlacement to a group.
-Peut être un sous-menu dans n’importe quel autre type de menu.- Can be a submenu in any other kind of menu.
-Apparaît automatiquement chaque fois que son menu parent s’affiche.- Is automatically displayed whenever its parent menu is displayed.
-Ne nécessitent pas l’implémentation de n’importe quel code de VSPackage pour rendre leur affichage.- Does not require the implementation of any VSPackage code to make it displayed.

MenuControllerMenuController
Fournit un menu déroulant de bouton partagé, qui est généralement utilisé dans les barres d’outils.Provides a split-button drop-down menu, which is typically used in toolbars. Un menu MenuController présente les caractéristiques suivantes :A MenuController menu has the following characteristics:

-Doit être contenue dans un autre menu via le Parent ou CommandPlacement.- Must be contained in another menu through Parent or CommandPlacement.
-Respecte le Parent dans sa définition.- Respects the Parent in its definition.
-Peut être n’importe quel type de menu parent.- Can have any kind of menu as its parent.
-Sont automatiquement disponibles chaque fois que son menu parent s’affiche.- Is automatically made available whenever its parent menu is displayed.
-Ne nécessitent pas la prise en charge par programmation pour rendre le menu qui s’affiche.- Does not require programmatic support to make the menu displayed.

Une commande dans le menu du bouton partagé est affichée sur le bouton de menu.A command from the split-button menu is displayed on the menu button. La commande affiche a l’une des caractéristiques suivantes :The command displayed has one of the following characteristics:

-Il est la dernière commande a été utilisée si la commande est toujours affichée et activée.- It is the last command that was used if the command is still displayed and enabled.
-Il est la première commande affichée.- It is the first displayed command.

MenuControllerLatchedMenuControllerLatched
Fournit un menu déroulant de bouton partagé pour lequel une commande peut être spécifiée en tant que la sélection par défaut en sélectionnant la commande comme verrouillée.Provides a split-button drop-down menu for which a command can be specified as the default selection by marking the command as latched.

Une commande verrouillée est une commande qui est marquée dans le menu sélectionné, généralement en affichant une case à cocher.A latched command is a command that is marked in the menu as selected, typically by displaying a check mark. Une commande peut être marquée comme verrouillée si elle a la OLECMDF_LATCHED l’indicateur est défini sur ce dernier dans une implémentation de la QueryStatus méthode de la IOleCommandTarget interface.A command can be marked as latched if it has the OLECMDF_LATCHED flag set on it in an implementation of the QueryStatus method of the IOleCommandTarget interface. Un menu MenuControllerLatched présente les caractéristiques suivantes :A MenuControllerLatched menu has the following characteristics:

-Doit être contenue dans un autre menu via un CommandPlacement ou un groupe Parent.- Must be contained in another menu through a Parent group or CommandPlacement.
-Respecte le Parent dans sa définition.- Respects the Parent in its definition.
-Peut être n’importe quel type de menu parent.- Can have any kind of menu as its parent.
-Sont disponibles chaque fois que son menu parent s’affiche.- Is made available whenever its parent menu is displayed.
-Ne nécessitent pas la prise en charge par programmation pour rendre le menu qui s’affiche.- Does not require programmatic support to make the menu displayed.

Une commande dans le menu du bouton partagé est affichée sur le bouton de menu.A command from the split-button menu is displayed on the menu button. La commande affiche a l’une des caractéristiques suivantes :The command displayed has one of the following characteristics:

-Il est la première commande affichée est verrouillée.- It is the first displayed command that is latched.
-Il est la première commande affichée.- It is the first displayed command.

ToolBarToolbar
Fournit une barre d’outils.Provides a toolbar. Une barre d’outils présente les caractéristiques suivantes :A toolbar has the following characteristics:

-Ignore le Parent dans sa définition.- Ignores the Parent in its definition.
-Impossible d’établir un sous-menu d’un groupe, même à l’aide de CommandPlacement.- Cannot be made a submenu of any group, not even by using CommandPlacement.
-Peut toujours être affichée en cliquant sur barres d’outils sur la vue menu.- Can always be displayed by clicking Toolbars on the View menu.
-Peuvent être affichés en utilisant un VisibilityItem.- Can be displayed by using a VisibilityItem.
-Ne requiert pas de code pour le créer.- Does not require any code to create it. Pour obtenir un exemple sur la création d’une barre d’outils, consultez Ajout d’une barre d’outils.For an example about how to create a toolbar, see Adding a Toolbar.

ToolWindowToolbarToolWindowToolbar
Fournit une barre d’outils qui est attaché à une fenêtre outil spécifique, comme une barre d’outils est attaché à l’environnement de développement.Provides a toolbar that is attached to a specific tool window, just as a toolbar is attached to the development environment.

-Ignore le Parent dans sa définition.- Ignores the Parent in its definition.
-Impossible d’établir un sous-menu d’un groupe, même à l’aide de CommandPlacement.- Cannot be made a submenu of any group, not even by using CommandPlacement.
-Est affichée uniquement lorsque la fenêtre outil qui héberge la barre d’outils s’affiche et le VSPackage ajoute explicitement la barre d’outils à la fenêtre outil.- Is displayed only when the tool window that hosts the toolbar is displayed and the VSPackage explicitly adds the toolbar to the tool window. Cette opération est généralement effectuée lors de la fenêtre outil est créée en obtenant la propriété de l’hôte de barre d’outils (telle que représentée par le IVsToolWindowToolbarHost interface) à partir de la frame de fenêtre outil et en appelant le AddToolbar (méthode).This is typically done when the tool window is created by obtaining the toolbar host property (as represented by the IVsToolWindowToolbarHost interface) from the tool window frame and then calling the AddToolbar method.
ConditionCondition Facultatif.Optional. Consultez attributs conditionnels.See Conditional Attributes.

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
ParentParent Facultatif.Optional. L’élément parent de l’élément de menu.The parent element of the menu item.
CommandFlagCommandFlag Obligatoire.Required. Consultez élément de l’indicateur de commande.See Command Flag Element. Les valeurs CommandFlag valides pour un Menu sont comme suit :The valid CommandFlag values for a Menu are as follows:

- AlwaysCreate- AlwaysCreate
- DefaultDocked- DefaultDocked
- DefaultInvisible -cet indicateur n’affecte pas l’affichage des barres d’outils.- DefaultInvisible - This flag does not affect the display of toolbars.
- DontCache- DontCache
- DynamicVisibility -cet indicateur n’affecte pas l’affichage des barres d’outils.- DynamicVisibility - This flag does not affect the display of toolbars.
- IconAndText- IconAndText
- NoCustomize- NoCustomize
- NotInTBList- NotInTBList
- NoToolbarClose- NoToolbarClose
- TextChanges- TextChanges
- TextIsAnchorCommand- TextIsAnchorCommand
ChaînesStrings Obligatoire.Required. Consultez chaînes élément.See Strings Element. L’enfant ButtonText élément doit être défini.The child ButtonText element must be defined.
AnnotationAnnotation Commentaire facultatif.Optional comment.

Éléments parentsParent Elements

ÉlémentElement DescriptionDescription
Élément MenusMenus Element Définit tous les menus un VSPackage implémente.Defines all the menus that a VSPackage implements.

ExempleExample

<Menu guid="cmdGuidWidgetCommands" id="menuIDEditWidget"  
  priority="0x0002" type="Menu">  
  <Parent guid="cmdSetGuidWidgetCommands" id="groupIDFileEdit">  
    <CommandFlag>AlwaysCreate</CommandFlag>  
    <Strings>  
      <ButtonText>Edit Widget</ButtonText>  
    </Strings>  
    </Parent>  
</Menu>  

Voir aussiSee Also

Fichiers Visual Studio Command Table (.Vsct)Visual Studio Command Table (.Vsct) Files