Udostępnij za pośrednictwem

Commands, element

  • Artykuł

Reprezentuje kolekcję poleceń na pasku narzędzi VSPackage. Kolekcja może zawierać maksymalnie pięć podsekcji, w następujący sposób: menu, grupy, przyciski, kombi i mapy bitowe.

Każdy element podrzędny podsekcji, na przykład <Menu>, jest identyfikowany przez unikatowy identyfikator polecenia, który jest identyfikatorem GUID i parą identyfikatorów liczbowych. Identyfikator GUID identyfikuje "zestaw poleceń" i służy do grupowania logicznie powiązanych poleceń. Pakiet VSPackage powinien zdefiniować własny zestaw poleceń, aby uniknąć kolizji z identyfikatorami poleceń zdefiniowanymi przez inne pakiety VSPackage.

Składnia

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

Atrybuty i elementy

W poniższych sekcjach opisano atrybuty, elementy podrzędne i elementy nadrzędne.

Atrybuty

Atrybut opis
package Identyfikator GUID identyfikujący pakiet VSPackage, który udostępnia polecenia.

Na przykład package="guidVsPackage1Pkg".

Elementy podrzędne

Element opis
Menu, element Definiuje wszystkie menu implementowane przez pakiet VSPackage.
Groups, element Zawiera wpisy definiujące grupy poleceń w programie VSPackage.
Element Przyciski Elementy przycisków grup.
Element Mapy bitowe Grupuje elementy mapy bitowej.
Combos, element Grupy elementy kombi.

Elementy nadrzędne

Element opis
CommandTable, element Definiuje wszystkie elementy reprezentujące polecenia, które program VSPackage udostępnia środowisku IDE. Możliwe elementy to elementy menu, menu, paski narzędzi i pola kombi.

Przykład

W poniższym przykładzie pokazano, jak używać elementu 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>

Zobacz też