Commands 元素

表示 VSPackage 工具栏上的命令集合。 集合最多可以有五个子节,如下所示:菜单、组、按钮、组合和位图。

每个子节子元素(例如 <Menu>)由 GUID 和数字标识符对的唯一命令 ID 标识。 GUID 标识“命令集”,用于对逻辑相关命令进行分组。 VSPackage 应定义自己的命令集,以避免与其他 VSPackage 定义的命令 ID 冲突。

语法

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

特性和元素

下列各节描述了特性、子元素和父元素。

特性

属性 说明
package 标识提供命令的 VSPackage 的 GUID。

例如,package=“guidVsPackage1Pkg”。

子元素

元素 说明
Menus 元素 定义 VSPackage 实现的所有菜单。
Groups 元素 包含定义 VSPackage 中的命令组的条目。
Buttons 元素 对 Button 元素进行分组。
Bitmaps 元素 对位图元素进行分组。
组合元素 对组合元素进行分组。

父元素

元素 说明
CommandTable 元素 定义表示 VSPackage 提供给 IDE 的命令的所有元素。 可能的元素包括菜单项、菜单、工具栏和组合框。

示例

以下示例演示如何使用 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>

另请参阅