Drop-Down ボタン
Drop-Down ボタンは、クリックすると相互に排他的な項目のドロップダウン リストを表示するボタンで構成されます。
細部
このコントロールは、明確な既定値が使用できない場合や、個々の項目を画像、テキスト、またはその両方で表すことができる場合に、密接に関連する項目を公開する場合に便利です。
次のスクリーン ショットは、サンプル リボンのリボン Drop-Down ボタンを示しています。
サンプル リボンのドロップダウン ボタン コントロールのスクリーン ショットを 
Drop-Down ボタンのプロパティ
リボン フレームワークは、Drop-Down Button コントロールに プロパティ キーのコレクションを定義します。
通常、Drop-Down Button プロパティは、IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられているコマンドを無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、IUICommandHandler::UpdateProperty コールバック メソッドによってプロパティが更新されます。
IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションは、フレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブになり、リボン UI にコントロールが表示されたときや、ツールヒントが表示されたときなどです。
手記
場合によっては、IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、IUIFramework::SetUICommandProperty メソッドで設定できます。
次の表に、Drop-Down Button コントロールに関連付けられているプロパティ キーの一覧を示します。
| プロパティ キー | 筆記 |
|---|---|
| UI_PKEY_Categories | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。 |
| UI_PKEY_Enabled | IUIFramework::GetUICommandPropertyおよび IUIFramework::SetUICommandPropertyをサポートします。 すべての子項目が無効になっている場合、フレームワークは UI_PKEY_Enabled を false (0) に設定します。 それ以外の場合、1 つ以上の子項目が有効になっている場合、UI_PKEY_Enabledは true (-1) に設定されます。 重要: 1 つ以上の子項目が有効または無効になった後、Drop-Down Button コントロールの UI_PKEY_Enabled プロパティを無効にする必要があります。 これにより、フレームワークは更新されたプロパティ値を照会し、リボン UI の Drop-Down Button コントロールの状態を更新します。 |
| 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をサポートします。
注: IUIFramework::InvalidateUICommand の呼び出しによってコントロールに関連付けられているコマンドが無効になった場合、フレームワークは、フラグの値として UI_INVALIDATIONS_VALUE が渡されたときに、このプロパティクエリを実行します。 |
| UI_PKEY_SmallHighContrastImage | 無効化によってのみ更新できます。 |
| UI_PKEY_SmallImage | 無効化によってのみ更新できます。 |
| UI_PKEY_TooltipDescription | 無効化によってのみ更新できます。 |
| UI_PKEY_TooltipTitle | 無効化によってのみ更新できます。 |