Elemento Commands

Artigo
01/12/2024

Representa a coleção de comandos na barra de ferramentas VSPackage. A coleção pode ter até cinco subseções, da seguinte forma: menus, grupos, botões, combinações e bitmaps.

Cada elemento filho da subseção, por exemplo, Menu>, <é identificado por um ID de comando exclusivo que é um par de GUID e identificador numérico. O GUID identifica o "conjunto de comandos" e é usado para agrupar comandos logicamente relacionados. O VSPackage deve definir seu próprio conjunto de comandos para evitar colisões com IDs de comando definidos por outros VSPackages.

Syntax

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

Atributos e elementos

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

Atributos

Atributo	Descrição
pacote	Um GUID que identifica o VSPackage que fornece os comandos. Por exemplo, package="guidVsPackage1Pkg".

Elementos filho

Elemento	Descrição
Elemento Menus	Define todos os menus que um VSPackage implementa.
Elemento Groups	Contém entradas que definem os grupos de comandos em um VSPackage.
Elemento Buttons	Elementos do botão Grupos.
Elemento Bitmaps	Agrupa elementos de bitmap.
Elemento Combos	Elementos de combinação de grupos.

Elementos pai

Elemento	Descrição
Elemento CommandTable	Define todos os elementos que representam os comandos que um VSPackage fornece ao IDE. Os elementos possíveis são itens de menu, menus, barras de ferramentas e caixas de combinação.

Exemplo

O exemplo a seguir mostra como usar um 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>

Partilhar via