按钮元素
定义用户可以与之交互的元素。 按钮可以是不同类型的：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>