次の方法で共有

Combo 要素

  • [アーティクル]

コンボ ボックスに表示されるコマンドを定義します。 次に示すように、DropDownCombo、DynamicCombo、IndexCombo、MRUCombo の 4 種類のコンボ ボックスがあります。

構文

<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 必須。 「コマンド フラグ要素」を参照してください。 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>

関連項目