按钮元素

定义用户可以与之交互的元素。 按钮可以是不同类型的:Button、MenuButton 和 SplitDropDown。

语法

<Button guid="guidMyCommandSet" id="MyCommand" priority="0x102" type="button">
  <Parent>... </Parent>
  <Icon>... </Icon>
  <CommandFlag>... </CommandFlag>
  <Strings>... </Strings>
</Button>

特性和元素

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

特性

属性 说明
guid 必需。 GUID/ID 命令标识符的 GUID。
id 必需。 GUID/ID 命令标识符的 ID。
priority 可选。 指定优先级的数值。
type 可选。 一个指定按钮类型的枚举值。

如果未指定,请使用 Button。

Button
显示在工具栏(通常为图标按钮)、菜单和上下文菜单上的标准命令。

MenuButton
不执行命令但生成另一个菜单的菜单项。

SplitDropDown
Microsoft Word 中标准工具栏上的“撤消”和“恢复”按钮等控件。
条件 可选。 请参阅 条件属性

子元素

元素 说明
父元素 可选。 按钮的父元素。
Icon 元素 可选。 与按钮关联的图标。
命令标志元素 必需。 按钮的有效 CommandFlag 值如下所示。

- AllowParams

- CommandWellOnly

- DefaultDisabled

- DefaultInvisible

- DontCache

- DynamicItemStart

- DynamicVisibility

- FixMenuController

- IconAndText

- NoButtonCustomize

- NoCustomize

- NoKeyCustomize

- NoShowOnMenuController

- Pict

- PostExec

- ProfferedCmd

- RouteToDocs

- TextCascadeUseBtn

- TextMenuUseButton

- TextChanges

- TextChangesButton

- TextContextUseButton

- TextMenuCtrlUseMenu

- TextMenuUseButton

- TextOnly
Strings 元素 必需。 必须定义子 ButtonText 元素
注释 可选注释。

父元素

元素 说明
Buttons 元素 对 Button 元素进行分组。

示例

以下示例定义 .vsct 文件中的按钮。

<Button guid="guidMenuTextCmdSet" id="cmdidMyCommand" priority="0x0100" type="Button">
   <Parent guid="guidMenuTextCmdSet" id="MyMenuGroup" />
   <Icon guid="guidImages" id="bmpPic1" />
   <CommandFlag>TextChanges</CommandFlag>
   <Strings>
         <CommandName>cmdidMyCommand</CommandName>
         <ButtonText>My Command name</ButtonText>
   </Strings>
</Button>

另请参阅