组合元素
定义组合框中显示的命令。 有四种类型的组合框，如下所示：DropDownCombo、DynamicCombo、IndexCombo 和 MRUCombo。
语法
<combo guid="guidMyCommandSet" id="MyCommand" defaultWidth="20" idCommandList="MyCommandListID" priority="0x102" type="DropDownCombo">
<Parent>... </Parent
<CommandFlag>... </CommandFlag>
<Strings>... </Strings>
</combo>
特性和元素
下列各节描述了特性、子元素和父元素。
特性
| 属性 | 说明 |
|---|---|
| guid | 必需。 GUID/ID 命令标识符的 GUID。 |
| id | 必需。 GUID/ID 命令标识符的 ID。 |
| defaultWidth | 必需。 一个整数，指定组合框的像素宽度。 |
| idCommandList | 必需。 发送到活动命令目标的 ID，用于检索要显示在组合框中的项目列表。 ID 将与控件位于同一 GUID 范围内。 |
| priority | 可选。 指定优先级的数值。 |
| type | 可选。 一个指定按钮类型的枚举值。 如果未指定，请使用 Button。 DropDownCombo VSPackage 负责填写此组合框的内容。 用户无法在此下拉列表的文本框中键入任何内容。 DynamicCombo VSPackage 负责填写此组合框的内容。 用户可以编辑此组合，还可以选择其中的项目。 IndexCombo 与 DynamicCombo 相同，只不过它引发项的索引而不是其文本。 MRUCombo 由代表 VSPackage 的集成开发环境（IDE）填充。 用户可以在此组合框中编辑。 IDE 每组合框最多记住最后 16 个条目。 当用户选择组合框中的内容或输入新内容时，IDE 会通知相应的 VSPackage。 |
| 条件 | 可选。 请参阅 条件属性。 |
子元素
| 元素 | 说明 |
|---|---|
| 父级 | 可选。 按钮的父元素。 |
| CommandFlag | 必需。 请参阅 Command 标志元素。 按钮的有效 CommandFlag 值如下所示。 - CaseSensitive - CommandWellOnly - DefaultDisabled - DefaultInvisible - DynamicVisibility - FilterKeys - IconAndText - NoAutoComplete - NoButtonCustomize - NoCustomize - NoKeyCustomize - StretchHorizontally |
| 字符串 | 必需。 请参阅 Strings 元素。 必须定义子 ButtonText 元素。 |
| 注释 | 可选注释。 |
父元素
| 元素 | 说明 |
|---|---|
| Commands 元素 | 表示 VSPackage 工具栏上的命令集合。 |
示例
<Combo guid="guidWidgetPackage" id="cmdidInsertOptions"
defaultWidth="100" idCommandList="cmdidGetInsertOptionsList">
<CommandFlag>DynamicVisibility</CommandFlag>
<Strings>
<ButtonText>Select Insert Options</ButtonText>
</Strings>
</Combo>
<Combo guid="guidWidgetPackage" id="cmdidInsertOptions"
priority="0x0500" type="DropDownCombo" defaultWidth="100"
idCommandList="cmdidGetInsertOptionsList">
<Parent guid="cmdSetGuidWidgetCommands" id="groupIDFileEdit">
<CommandFlag>DynamicVisibility</CommandFlag>
<Strings>
<ButtonText>Select Insert Options</ButtonText>
</Strings>
</Combo>