Elemento de botón

  • Artículo

Define un elemento con el que el usuario puede interactuar. Los botones pueden ser de diferentes tipos: Button, MenuButton y SplitDropDown.

Sintaxis

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

Atributos y elementos

En las siguientes secciones se describen los atributos, los elementos secundarios y los elementos primarios.

Atributos

Atributo Descripción
guid Necesario. GUID del identificador de comando GUID/ID.
id Necesario. Identificador del identificador de comando GUID/ID.
priority Opcional. Valor numérico que especifica la prioridad.
type Opcional. Valor enumerado que especifica el tipo de botón.

Si no se da, usa Button.

Button
Un comando estándar que aparece en las barras de herramientas (normalmente como un botón emblemático), menús y menús contextuales.

MenuButton
Un elemento de menú que no ejecuta un comando, pero genera otro menú.

SplitDropDown
Controles, como los botones Deshacer y Rehacer en la barra de herramientas estándar de Microsoft Word.
Condición Opcional. Consulte Atributos condicionales.

Elementos secundarios

Elemento Descripción
Elemento primario Opcional. Elemento primario del botón.
Elemento Icon Opcional. Icono asociado al botón.
Elemento de marca de comandos Necesario. Los valores de CommandFlag válidos para un botón son los siguientes.

- 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
Elemento Strings Necesario. Se debe definir el elemento ButtonText secundario.
Annotation Comentario opcional.

Elementos primarios

Elemento Descripción
Elemento Buttons Elementos Button de grupos.

Ejemplo

En el ejemplo siguiente se define un botón en un archivo .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 también