Elemento de comandos

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

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

<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 fornece os comandos. Por exemplo, pacote = "guidVsPackage1Pkg".

Elementos filho

Elemento	Descrição
Elemento de menus	Define todos os menus que implementa um VSPackage.
Elemento de grupos	Contém entradas que definem os grupos de comando em um VSPackage.
Elemento de botões	Agrupa elementos Button.
Elemento de bitmaps	Agrupa elementos de Bitmap.
Elemento combos	Agrupa elementos de combinação.

Elementos pai

Elemento	Descrição
Elemento de CommandTable	Define os elementos que representam os comandos VSPackage fornece ao IDE. 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 de comandos.

<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>

Consulte também

Conceitos

Como a VSPackages adicionar elementos de Interface do usuário ao IDE

Outros recursos

Comandos, Menus e barras de ferramentas