Commands-Element

Stellt die Auflistung der Befehle in der VSPackage-Symbolleiste dar. Die Auflistung kann bis zu fünf Unterabschnitte enthalten: Menüs, Gruppen, Schaltflächen, Kombinationsfelder und Bitmaps.

Jedes untergeordnete Element eines Unterabschnitts z. B. <Menüs>, wird durch eine eindeutige Befehls-ID identifiziert, die eine GUID und numerischen Bezeichner paare ist. Die GUID kennzeichnet den Befehl festgelegten "und" wird verwendet, um verwandte Befehle logisch gruppiert. VSPackage sollte über einen eigenen Befehls Gruppe definieren, um Konflikte mit Befehls-IDs zu vermeiden, die von anderen VSPackages definiert sind.

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

Attribute und Elemente

In den folgenden Abschnitten werden Attribute sowie untergeordnete und übergeordnete Elemente beschrieben.

Attribute

Attribut	Beschreibung
package	Eine GUID, die ein VSPackage identifiziert, das die Befehle enthält. Zum Beispiel package= " guidVsPackage1Package".

Untergeordnete Elemente

Element	Beschreibung
Menus-Element	Definiert alle Menüs, die ein VSPackage implementieren.
Groups-Element	Enthält Einträge, die die Befehlsgruppen in einem VSPackage definieren.
Buttons-Element	Gruppen-Schaltflächen Elemente.
Bitmaps-Element	Gruppiert Elemente erstellen.
Combos-Element	Gruppen-Kombinationsfeld Elemente.

Übergeordnete Elemente

Element	Beschreibung
CommandTable-Element	Definiert alle Elemente, die die Befehle darstellen, die einem VSPackage in der IDE bereitgestellt werden. Folgende Elemente werden Menüelemente, Menüs, Symbolleisten und Kombinationsfelder.

Beispiel

Das folgende Beispiel veranschaulicht die Verwendung eines Commands-Element.

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

Siehe auch

Konzepte

Wie VSPackages Benutzeroberflächenelemente Hinzufügen der IDE

Weitere Ressourcen

Befehle, Menüs und Symbolleisten