Drop-Down ボタン

  • [アーティクル]

Drop-Down ボタンは、クリックすると相互に排他的な項目のドロップダウン リストを表示するボタンで構成されます。

説明

このコントロールは、明確な既定値が使用できない場合や、個々の項目を画像、テキスト、またはその両方で表すことができる場合に、密接に関連する項目を公開する場合に役立ちます。

次のスクリーン ショットは、サンプル リボンのリボン Drop-Down ボタンを示しています。

サンプル リボンのドロップダウン ボタン コントロールのスクリーン ショット。

リボン フレームワークは、Drop-Down Button コントロールの プロパティ キー のコレクションを定義します。

通常、Drop-Down Button プロパティは、 IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられている Command を無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、 IUICommandHandler::UpdateProperty コールバック メソッドによってプロパティが更新されます。

IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションはフレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブ化され、リボン UI に表示されるコントロールや、ツールヒントが表示されたときなどです。

注意

場合によっては、 IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、 IUIFramework::SetUICommandProperty メソッドで設定できます。

次の表に、Drop-Down Button コントロールに関連付けられているプロパティ キーを示します。

プロパティ キー Notes
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) に設定されます。 重要:
Drop-Down Button コントロールの UI_PKEY_Enabled プロパティは、1 つ以上の子項目を有効または無効にした後で無効にする必要があります。 これにより、フレームワークは更新されたプロパティ値に対してクエリを実行し、リボン 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 をサポートします。 メモ： コントロールに関連付けられている Command が IUIFramework::InvalidateUICommand の呼び出しによって無効化された場合、フレームワークは フラグの値として が渡されたときに UI_INVALIDATIONS_VALUE このプロパティに対してクエリを実行 します。
UI_PKEY_SmallHighContrastImage 無効化によってのみ更新できます。
UI_PKEY_SmallImage 無効化によってのみ更新できます。
UI_PKEY_TooltipDescription 無効化によってのみ更新できます。
UI_PKEY_TooltipTitle 無効化によってのみ更新できます。

Windows リボン フレームワーク コントロール ライブラリ

DropDownButton マークアップ要素