Commands, élément

  • Article

Représente la collection de commandes dans la barre d’outils VSPackage. La collection peut comporter jusqu’à cinq sous-sections, comme suit : menus, groupes, boutons, combos et bitmaps.

Chaque élément enfant de sous-section, par exemple <, Menu>, est identifié par un ID de commande unique qui est une paire GUID et identificateur numérique. Le GUID identifie le « jeu de commandes » et est utilisé pour regrouper les commandes liées logiquement. VsPackage doit définir son propre jeu de commandes pour éviter les collisions avec les ID de commande définis par d’autres VSPackages.

Syntaxe

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

Attributs et éléments

Les sections suivantes décrivent des attributs, des éléments enfants et des éléments parents.

Attributs

Attribut Description
package GUID qui identifie le VSPackage qui fournit les commandes.

Par exemple, package="guidVsPackage1Pkg ».

Éléments enfants

Élément Description
Élément Menus Définit tous les menus implémentés par un VSPackage.
Élément Groups Contient des entrées qui définissent les groupes de commandes dans un VSPackage.
Élément Buttons Groupes d’éléments Button.
Élément Bitmaps Regroupe les éléments Bitmap.
Élément Combos Regroupe les éléments combo.

Éléments parents

Élément Description
Élément CommandTable Définit tous les éléments qui représentent les commandes qu’un VSPackage fournit à l’IDE. Les éléments possibles sont des éléments de menu, des menus, des barres d’outils et des zones de liste modifiable.

Exemple

L’exemple suivant montre comment utiliser un élément 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>

Voir aussi