Элемент Commands

Статья
01/12/2024

Представляет коллекцию команд на панели инструментов VSPackage. Коллекция может содержать до пяти подразделов, как показано ниже: меню, группы, кнопки, списки и растровые изображения.

Каждый дочерний элемент подраздела, например <Menu>, определяется уникальным идентификатором команды, который является парой GUID и числовых идентификаторов. GUID определяет "набор команд" и используется для группировки логически связанных команд. VSPackage должен определять собственный набор команд, чтобы избежать конфликтов с идентификаторами команд, определенными другими VSPackage.

Синтаксис

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

Элементы и атрибуты

В следующих разделах описаны атрибуты, дочерние и родительские элементы.

Атрибуты

Атрибут	Description
package	ИДЕНТИФИКАТОР GUID, определяющий VSPackage, предоставляющий команды. Например, package="guidVsPackage1Pkg".

Дочерние элементы

Элемент	Description
Элемент Menus	Определяет все меню, которые реализует VSPackage.
Элемент Groups	Содержит записи, определяющие группы команд в VSPackage.
Элемент Button	Элементы "Группы кнопок".
Элемент Bitmaps	Группируемые элементы растрового изображения.
Элемент Combos	Группы элементов со списком.

Родительские элементы

Элемент	Description
Элемент CommandTable	Определяет все элементы, представляющие команды, которые предоставляет VSPackage интегрированной среде разработки. Возможные элементы: пункты меню, меню, панели инструментов и поля со списком.

Пример

В следующем примере показано, как использовать элемент 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>

Поделиться через