Élément de bouton

  • Article

Définit un élément avec lequel l’utilisateur peut interagir. Les boutons peuvent être de différents types : Button, MenuButton et SplitDropDown.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
guid Obligatoire. GUID de l’identificateur de commande GUID/ID.
id Obligatoire. ID de l’identificateur de commande GUID/ID.
priority facultatif. Valeur numérique qui spécifie la priorité.
type facultatif. Valeur énumérée qui spécifie le type de bouton.

Si ce n’est pas le cas, utilise Button.

Button
Commande standard qui apparaît dans les barres d’outils (généralement sous forme de bouton emblématique), de menus et de menus contextuels.

MenuButton
Élément de menu qui n’exécute pas de commande, mais produit un autre menu.

SplitDropDown
Contrôles, tels que les boutons Annuler et Rétablir dans la barre d’outils standard de Microsoft Word.
Condition facultatif. Consultez les attributs conditionnels.

Éléments enfants

Élément Description
Élément parent facultatif. Élément parent du bouton.
Élément Icon facultatif. Icône associée au bouton.
Élément d’indicateur de commande Obligatoire. Les valeurs CommandFlag valides pour un bouton sont les suivantes.

- AllowParams

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DontCache

- DynamicItemStart

- DynamicVisibility

- FixMenuController

- IconAndText

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- NoShowOnMenuController

-Pict

- PostExec

- ProfferedCmd

- RouteToDocs

- TextCascadeUseBtn

- TextMenuUseButton

- TextChanges

- TextChangesButton

- TextContextUseButton

- TextMenuCtrlUseMenu

- TextMenuUseButton

- TextOnly
Élément Strings Obligatoire. L’élément ButtonText enfant doit être défini.
Annotation Commentaire facultatif.

Éléments parents

Élément Description
Élément Buttons Groupes d’éléments Button.

Exemple

L’exemple suivant définit un bouton dans un fichier .vsct .

<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 aussi