組合元素
定義出現在下拉式方塊中的命令。 下拉式方塊有四種，如下所示：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 命令標識碼的標識碼。 |
| defaultWidth | 必要。 整數，指定下拉式方塊的像素寬度。 |
| idCommandList | 必要。 傳送至使用中命令目標的標識碼，以擷取要顯示在下拉式方塊中的項目清單。 標識符會位於與控件相同的 GUID 範圍中。 |
| priority | 選擇性。 指定優先權的數值。 |
| type | 選擇性。 指定按鈕類型的列舉值。 如果未指定，請使用 Button。 DropDownCombo VSPackage 負責填入此下拉式方塊的內容。 用戶無法在此下拉式清單的文字框中輸入任何專案。 DynamicCombo VSPackage 負責填入此下拉式方塊的內容。 用戶可以編輯此下拉式組合，也可以選取其中的專案。 IndexCombo 與 DynamicCombo 相同，不同之處在於它會引發專案的索引，而不是其文字。 MRUCombo 代表 VSPackage 填入整合開發環境 （IDE）。 用戶可以在此下拉式方塊中編輯。 IDE 會記住每個下拉式方塊最後 16 個專案。 當使用者在下拉式方塊中選取某個專案，或輸入新的專案時，IDE 會通知適當的 VSPackage。 |
| Condition | 選擇性。 請參閱 條件屬性。 |
子元素
| 元素 | 描述 |
|---|---|
| 上層 | 選擇性。 按鈕的父元素。 |
| CommandFlag | 必要。 請參閱 Command flag 元素。 Button 的有效 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>