Elemento Comandos

Artículo
01/12/2024

Representa la colección de comandos de la barra de herramientas de VSPackage. La colección puede tener hasta cinco subsecciones, como se indica a continuación: menús, grupos, botones, combos y mapas de bits.

Cada elemento secundario de subsección, por ejemplo, <Menu>, se identifica mediante un identificador de comando único que es un GUID y un par de identificadores numéricos. El GUID identifica el "conjunto de comandos" y se usa para agrupar comandos relacionados lógicamente. VSPackage debe definir su propio conjunto de comandos para evitar colisiones con identificadores de comando definidos por otros VSPackages.

Sintaxis

<Commands package="GuidMyPackage" >
  <Menus>... </Menus>
  <Groups>... </Groups>
  <Buttons>... </Buttons>
  <Combos>... </Combos>
  <Bitmaps>... </Bitmaps>
</Commands>

Atributos y elementos

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

Atributos

Atributo	Descripción
paquete	GUID que identifica el VSPackage que proporciona los comandos. Por ejemplo, package="guidVsPackage1Pkg".

Elementos secundarios

Elemento	Descripción
Elemento Menus	Define todos los menús que implementa un VSPackage.
Elemento Groups	Contiene entradas que definen los grupos de comandos en un VSPackage.
Elemento Buttons	Elementos Button de grupos.
Elemento Bitmaps	Grupos Elementos de mapa de bits.
Elemento Combos	Agrupa elementos Combo.

Elementos primarios

Elemento	Descripción
Elemento CommandTable	Define todos los elementos que representan los comandos que proporciona un VSPackage al IDE. Los elementos posibles son elementos de menú, menús, barras de herramientas y cuadros combinados.

Ejemplo

En el ejemplo siguiente se muestra cómo usar un elemento Commands.

<Commands package="guidMyPackage">
    <Menus>
      <Menu Condition="'%(DEBUG)' != 'true'"
        guid="cmdSetGuidMyProductCommands" id="menuIDMainMenu"
        priority="0x0000" type="Menu">
        <Annotation>
          <Documentation>this is an annotation</Documentation>
          <AppInfo>
            <CustomData>
              <CustomSubElement>Some data</CustomSubElement>
            </CustomData>
          </AppInfo>
        </Annotation>
        <CommandFlag>AlwaysCreate</CommandFlag>
        <Strings>
          <ButtonText>MainMenu</ButtonText>
        </Strings>
      </Menu>
  </Menus>
<Commands>

Compartir vía