Button, élément

Article
05/17/2015

définit un élément avec lequel l'utilisateur peut interagir. Il existe quatre types de boutons, comme suit : Bouton, MenuButton, SplitDropDown, et échantillonnage.

<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. Le GUID de l'identificateur de commande de GUID/ID.
id	Obligatoire. ID de l'identificateur de commande de GUID/ID.
priority	Facultatif. Une valeur numérique qui indique la priorité.
type	Facultatif. Valeur énumérée qui spécifie le type de bouton. Si non donné, bouton d'usage. Button Une commande standard qui apparaît sur les barres d'outils (en général comme bouton iconique), de menus, et des menus contextuels. MenuButton Un élément de menu qui ne s'exécute pas la commande, mais produit un autre menu. SplitDropDown Contrôles, tels que les boutons d'annulation et de rétablissement dans la barre d'outils standard de Microsoft Word.
Condition	Facultatif. Consultez Attributs conditionnels de schéma XML VSCT.

Éléments enfants

Élément parent

Facultatif. l'élément parent du bouton.

Icon, élément

Facultatif. L'icône associée à le bouton.

CommandFlag, élément

Obligatoire. Les valeurs valides de CommandFlag d'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

Strings, élément

Obligatoire. ButtonText, élément enfant doit être défini.

Annotation

commentaire facultatif.

Éléments parents

Élément	Description
Buttons, élément	Éléments de groupes.

Exemple

l'exemple suivant définit un bouton dans un fichier de .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

Autres ressources

Tableau de commande Visual Studio (. fichiers de Vsct)

Partager via