Partilhar via


Elemento button

Define um elemento que o usuário pode interagir com. Existem quatro tipos de botões, da seguinte maneira: botão de menu, botão, SplitDropDown e amostra.

<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 do GUID/ID.

id

Obrigatório. ID do identificador de comando do 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 especificado, usa o botão.

Button

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

Botão de menu

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

SplitDropDown

Controles, como, por exemplo, os botões Desfazer e refazer na barra de ferramentas padrão no Microsoft Word.

Condição

Opcional. Consulte Atributos de condicional do esquema XML VSCT.

Elementos filho

Elemento

Descrição

Elemento pai

Opcional. O elemento pai do botão.

Elemento de ícone

Opcional. O ícone associado ao botão.

Elemento de sinalizador de comando

Obrigatório. Os valores CommandFlag válidos para um botão são os seguintes.

AllowParams

CommandWellOnly

DefaultDisabled

DefaultInvisible

DontCache

DynamicItemStart

DynamicVisibility

FixMenuController

IconAndText

NoButtonCustomize

NoCustomize

NoKeyCustomize

NoShowOnMenuController

PICT

PostExec

ProfferedCmd

RouteToDocs

TextCascadeUseBtn

TextMenuUseButton

TextoAltera

TextChangesButton

TextContextUseButton

TextMenuCtrlUseMenu

TextMenuUseButton

TextOnly

Elemento de seqüências de caracteres

Obrigatório. O filho Elemento de texto de botão deve ser definido.

Anotação

Comentário opcional.

Elementos pai

Elemento

Descrição

Elemento de botões

Agrupa elementos do botão.

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>

Consulte também

Outros recursos

Tabela Visual Studio de comando (.Arquivos de VSCT)