Commands 元素
表示 VSPackage 工具列上的命令集合。 集合最多可以有五個子區段,如下所示:功能表、群組、按鈕、下拉式清單和點陣圖。
每個子專案,例如 <Menu>,都是由 GUID 和數值識別碼組的唯一命令標識碼來識別。 GUID 會識別「命令集」,並用來將邏輯相關的命令分組。 VSPackage 應該定義自己的命令集,以避免與其他 VSPackage 所定義的命令標識符發生衝突。
語法
<Commands package="GuidMyPackage" >
<Menus>... </Menus>
<Groups>... </Groups>
<Buttons>... </Buttons>
<Combos>... </Combos>
<Bitmaps>... </Bitmaps>
</Commands>
屬性和元素
下列章節說明屬性、子元素和父元素。
屬性
屬性 | 描述 |
---|---|
套件 | 識別提供命令之 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>