組合元素

定義出現在下拉式方塊中的命令。 下拉式方塊有四種，如下所示：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>

另請參閱

• Visual Studio 命令表 （.vsct） 檔案