Elemento Commands

Articolo
01/12/2024

Rappresenta la raccolta di comandi sulla barra degli strumenti VSPackage. La raccolta può avere fino a cinque sottosezioni, come indicato di seguito: menu, gruppi, pulsanti, combo e bitmap.

Ogni elemento figlio della sottosezione, ad esempio Menu>, <è identificato da un ID comando univoco che è una coppia GUID e identificatore numerico. Il GUID identifica il "set di comandi" e viene usato per raggruppare i comandi correlati logicamente. Il pacchetto VSPackage deve definire il proprio set di comandi per evitare conflitti con gli ID comando definiti da altri pacchetti VSPackage.

Sintassi

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

Attributi ed elementi

Nelle sezioni seguenti vengono descritti gli attributi, gli elementi figlio e gli elementi padre.

Attributi

Attributo	Descrizione
pacchetto	GUID che identifica il VSPackage che fornisce i comandi. Ad esempio, package="guidVsPackage1Pkg".

Elementi figlio

Elemento	Descrizione
Elemento Menus	Definisce tutti i menu implementati da un VSPackage.
Elemento Groups	Contiene voci che definiscono i gruppi di comandi in un pacchetto VSPackage.
Elemento Buttons	Raggruppa gli elementi Button.
Elemento Bitmaps	Raggruppa gli elementi Bitmap.
Elemento Combos	Raggruppa gli elementi combo.

Elementi padre

Elemento	Descrizione
Elemento CommandTable	Definisce tutti gli elementi che rappresentano i comandi forniti da un VSPackage all'IDE. Gli elementi possibili sono voci di menu, menu, barre degli strumenti e caselle combinate.

Esempio

Nell'esempio seguente viene illustrato come usare un 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>

Condividi tramite