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>