Commands-Element

Artikel
01/12/2024

Stellt die Auflistung von Befehlen auf der VSPackage-Symbolleiste dar. Die Auflistung kann bis zu fünf Unterabschnitte wie folgt aufweisen: Menüs, Gruppen, Schaltflächen, Kombinationen und Bitmaps.

Jedes untergeordnete Unterabschnittselement, z <. B. Menu>, wird durch eine eindeutige Befehls-ID identifiziert, die ein GUID- und numerisches Bezeichnerpaar ist. Die GUID identifiziert den "Befehlssatz" und wird verwendet, um logisch verwandte Befehle zu gruppieren. VsPackage sollte einen eigenen Befehlssatz definieren, um Konflikte mit Befehls-IDs zu vermeiden, die von anderen VSPackages definiert werden.

Syntax

<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 das VSPackage identifiziert, das die Befehle bereitstellt. Beispiel: package="guidVsPackage1Pkg".

Untergeordnete Elemente

Element	Beschreibung
Menus-Element	Definiert alle Menüs, die ein VSPackage implementiert.
Groups-Element	Enthält Einträge, die die Befehlsgruppen in einem VSPackage definieren.
Buttons-Element	Gruppenschaltflächenelemente.
Bitmaps-Element	Gruppiert Bitmapelemente.
Combos-Element	Gruppiert Kombinationselemente.

Übergeordnete Elemente

Element	Beschreibung
CommandTable-Element	Definiert alle Elemente, die die Befehle darstellen, die ein VSPackage für die IDE bereitstellt. Mögliche Elemente sind Menüelemente, Menüs, Symbolleisten und Kombinationsfelder.

Beispiel

Das folgende Beispiel zeigt, wie Sie ein Commands-Element verwenden.

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

Freigeben über