Élément de boutonButton Element

Définit un élément de l’utilisateur peut interagir avec.Defines an element that the user can interact with. Boutons peuvent être de différents types : bouton, bouton de menu et SplitDropDown.Buttons can be of different kinds: Button, MenuButton, and SplitDropDown.

SyntaxeSyntax

<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">  
  <Parent>... </Parent>  
  <Icon>... </Icon>  
  <CommandFlag>... </CommandFlag>  
  <Strings>... </Strings>  
</Button>  

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 priorité.A numeric value that specifies the priority.
typetype Facultatif.Optional. Valeur énumérée qui spécifie le type de bouton.An enumerated value that specifies the kind of button.

Si non, utilise le bouton.If not given, uses Button.

BoutonButton
Commande standard qui apparaît sur les barres d’outils (en général sous forme de bouton sous forme d’icône), menus et des menus contextuels.A standard command that appears on toolbars (typically as an iconic button), menus, and context menus.

Bouton de menuMenuButton
Un élément de menu qui ne s’exécute pas une commande, mais génère un autre menu.A menu item that does not execute a command, but produces another menu.

SplitDropDownSplitDropDown
Contrôles, tels que les boutons Annuler et rétablir la barre d’outils standard dans Microsoft Word.Controls, such as the Undo and Redo buttons on the standard toolbar in Microsoft Word.
ConditionCondition Facultatif.Optional. Consultez attributs conditionnels.See Conditional Attributes.

Éléments enfantsChild Elements

ÉlémentElement DescriptionDescription
Élément ParentParent Element Facultatif.Optional. L’élément parent du bouton.The parent element of the button.
Élément IconIcon Element Facultatif.Optional. L’icône associée au bouton.The icon associated with the button.
Élément Command FlagCommand Flag Element Obligatoire.Required. Voici les valeurs CommandFlag valides pour un bouton.The valid CommandFlag values for a Button are as follows.

-AllowParams- AllowParams

-CommandWellOnly- CommandWellOnly

-DefaultDisabled- DefaultDisabled

-DefaultInvisible- DefaultInvisible

-DontCache- DontCache

-DynamicItemStart- DynamicItemStart

-DynamicVisibility- DynamicVisibility

-FixMenuController- FixMenuController

-IconAndText- IconAndText

-NoButtonCustomize- NoButtonCustomize

-NoCustomize- NoCustomize

-NoKeyCustomize- NoKeyCustomize

-NoShowOnMenuController- NoShowOnMenuController

-Pict- Pict

-PostExec- PostExec

-ProfferedCmd- ProfferedCmd

-RouteToDocs- RouteToDocs

-TextCascadeUseBtn- TextCascadeUseBtn

-TextMenuUseButton- TextMenuUseButton

-TextChanges- TextChanges

-TextChangesButton- TextChangesButton

-TextContextUseButton- TextContextUseButton

-TextMenuCtrlUseMenu- TextMenuCtrlUseMenu

-TextMenuUseButton- TextMenuUseButton

-TextOnly- TextOnly
Élément StringsStrings Element Obligatoire.Required. 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 ButtonsButtons Element Regroupe les éléments de bouton.Groups Button elements.

ExempleExample

L’exemple suivant définit un bouton dans un fichier .vsct.The following example defines a button in a .vsct file.

<Button guid="guidMenuTextCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
   <Parent guid="guidMenuTextCmdSet" id="MyMenuGroup" />
   <Icon guid="guidImages" id="bmpPic1" />
   <CommandFlag>TextChanges</CommandFlag>
   <Strings>
         <CommandName>cmdidMyCommand</CommandName>
         <ButtonText>My Command name</ButtonText>
   </Strings>
</Button>

Voir aussiSee Also

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