Partilhar via


Elemento de botão

Define um elemento com o qual o usuário pode interagir. Os botões podem ser de diferentes tipos: Button, MenuButton e SplitDropDown.

Syntax

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

Atributos e elementos

As seções a seguir descrevem atributos, elementos filho e elementos pai.

Atributos

Atributo Descrição
guid Obrigatório. GUID do identificador de comando GUID/ID.
ID Obrigatório. ID do identificador de comando GUID/ID.
priority Opcional. Um valor numérico que especifica a prioridade.
tipo Opcional. Um valor enumerado que especifica o tipo de botão.

Se não for fornecido, usa Button.

Botão
Um comando padrão que aparece em barras de ferramentas (normalmente como um botão icônico), menus e menus de contexto.

MenuButton
Um item de menu que não executa um comando, mas produz outro menu.

SplitDropDown
Controles, como os botões Desfazer e Refazer na barra de ferramentas padrão no Microsoft Word.
Condição Opcional. Consulte Atributos condicionais.

Elementos filho

Elemento Descrição
Elemento pai Opcional. O elemento pai do botão.
Elemento ícone Opcional. O ícone associado ao botão.
Elemento de sinalizador de comando Obrigatório. Os valores CommandFlag válidos para um Button são os seguintes.

- AllowParams

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DontCache

- DynamicItemStart

- Visibilidade dinâmica

- FixMenuController

- IconAndText

- NoButtonCustomize

- NãoPersonalizar

- NoKeyCustomize

- NoShowOnMenuController

-Pict

- PostExec

- ProfferCmd

- RouteToDocs

- TextCascadeUseBtn

- TextMenuUseButton

- Mudanças de texto

- TextChangesButton

- TextContextUseButton

- TextMenuCtrlUseMenu

- TextMenuUseButton

- Somente texto
Elemento Strings Obrigatório. O elemento filho ButtonText deve ser definido.
Anotação Comentário opcional.

Elementos pai

Elemento Descrição
Elemento Buttons Elementos do botão Grupos.

Exemplo

O exemplo a seguir define um botão em um arquivo .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>

Confira também