コンボ ボックス (Windows リボン フレームワーク)
コンボ ボックスは、静的コントロールまたは編集コントロールとドロップダウン矢印を組み合わせた、相互に排他的な項目またはコマンドのコレクションを含む単一列のリスト ボックスで構成されます。 ユーザーがドロップダウン矢印をクリックすると、コントロールのリスト ボックス部分が表示されます。
細部
リスト ボックスで現在選択されている項目またはコマンド (存在する場合) は、静的コントロールまたは編集コントロールに表示されます。 編集コントロールでは、ユーザーが既存の項目またはコマンドの初期文字を入力した場合、リスト ボックスは最初の項目とその初期文字を強調表示し、編集コントロールのエントリをオートコンプリートします。
垂直グリッパー バーまたはサイズ変更ハンドルのみをサポートします。
このコントロールは、密接に関連する単純なテキスト項目を公開する場合に便利です。
次のスクリーン ショットは、Live Movie Maker のリボン コンボ ボックスを示しています。
microsoft ペイント リボンのコンボ ボックス コントロールのスクリーン ショットを
コンボ ボックスのプロパティ
リボン フレームワークは、コンボ ボックス コントロールに プロパティ キーのコレクションを定義します。
通常、コンボ ボックス プロパティは、IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられているコマンドを無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、IUICommandHandler::UpdateProperty コールバック メソッドによってプロパティが更新されます。
IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションは、フレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブになり、リボン UI にコントロールが表示されたときや、ツールヒントが表示されたときなどです。
手記
場合によっては、IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、IUIFramework::SetUICommandProperty メソッドで設定できます。
次の表に、コンボ ボックス コントロールに関連付けられているプロパティ キーの一覧を示します。
プロパティ キー | 筆記 |
---|---|
UI_PKEY_Categories | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。 |
UI_PKEY_Enabled | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。 |
UI_PKEY_ItemsSource | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。 |
UI_PKEY_Keytip | 無効化によってのみ更新できます。 |
UI_PKEY_Label | 無効化によってのみ更新できます。 |
UI_PKEY_LargeHighContrastImage | 無効化によってのみ更新できます。 |
UI_PKEY_LargeImage | 無効化によってのみ更新できます。 |
UI_PKEY_SelectedItem | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。 |
UI_PKEY_SmallHighContrastImage | 無効化によってのみ更新できます。 |
UI_PKEY_SmallImage | 無効化によってのみ更新できます。 |
UI_PKEY_StringValue | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。
注: IUIFramework::InvalidateUICommand の呼び出しによってコントロールに関連付けられているコマンドが無効になった場合、フレームワークは、フラグの値として UI_INVALIDATIONS_VALUE が渡されたときに、このプロパティクエリを実行します。 |
UI_PKEY_TooltipDescription | 無効化によってのみ更新できます。 |
UI_PKEY_TooltipTitle | 無効化によってのみ更新できます。 |