É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. Une 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. Une 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.

Si elle est absente, le type par défaut est de Menu.If not present, the default type is Menu.

ContexteContext
Un menu contextuel qui s’affiche quand 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’utilise pas le Parent et priorité champs 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.
-Utilisable en tant que sous-menu et également comme un menu contextuel.- Can be used as a submenu and also as a shortcut menu. Dans ce cas, les deux ID de groupe et priorité champs 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 l’héberge est affichée.- 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 le 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écessite pas l’implémentation de n’importe quel code VSPackage pour la rendre affiché.- Does not require the implementation of any VSPackage code to make it displayed.

MenuControllerMenuController
Fournit un menu déroulant du 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 contenu dans un autre menu 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.
-Vous pouvez avoir n’importe quel type de menu en tant que son parent.- Can have any kind of menu as its parent.
-Est automatiquement mis à disposition dès que son menu parent s’affiche.- Is automatically made available whenever its parent menu is displayed.
-Ne nécessite pas de 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 qui 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 comme la sélection par défaut en marquant 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 comme étant sélectionnée, généralement en affichant une coche.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 contenu dans un autre menu via un groupe Parent ou le CommandPlacement.- 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.
-Vous pouvez avoir n’importe quel type de menu en tant que son parent.- Can have any kind of menu as its parent.
-Est accessible à chaque fois que son menu parent s’affiche.- Is made available whenever its parent menu is displayed.
-Ne nécessite pas de 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 qui 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, pas 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 le vue menu.- Can always be displayed by clicking Toolbars on the View menu.
-Peuvent être affichées 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 ajouter une barre d’outils.For an example about how to create a toolbar, see Add a toolbar.

ToolWindowToolbarToolWindowToolbar
Fournit une barre d’outils qui est attaché à une fenêtre outil spécifique, comme une barre d’outils est associé à 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, pas 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 est affichée et que 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. Cela est généralement le cas lors de la fenêtre outil est créée en obtenant la propriété d’hôte de barre d’outils (telle que représentée par le IVsToolWindowToolbarHost interface) à partir du frame de fenêtre outil et l’appeler ensuite la 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 Command flag.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 élément Strings.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 qui implémente un VSPackage.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 de la table de commande Visual Studio (.vsct)Visual Studio command table (.vsct) Files