分割ボタン ギャラリー

分割ボタン ギャラリーは、1 つの既定の項目またはコマンドを公開する主要なボタンと、項目または Command コレクションの残りの部分を相互に排他的なドロップダウン リストに表示するセカンダリ ボタンを含む複合コントロールです。

詳細

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

次のスクリーン ショットは、Microsoft ペイントのリボン分割ボタン ギャラリーを示しています。

screen shot of a splitbuttongallery control in the microsoft paint ribbon.

リボン フレームワークは、分割ボタン ギャラリー コントロールの プロパティ キー のコレクションを定義します。

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

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

Note

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

次の表に、分割ボタン ギャラリー コントロールに関連付けられているプロパティ キーの一覧を示します。

プロパティ キー メモ
UI_PKEY_BooleanValue IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty をサポートします。
UI_PKEY_Categories IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty をサポートします。
UI_PKEY_Enabled IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty をサポートします。
UI_PKEY_ItemsSource IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty をサポートします。
UI_PKEY_Keytip 無効化によってのみ更新できます。
UI_PKEY_Label 無効化によってのみ更新できます。
UI_PKEY_LargeHighContrastImage 無効化によってのみ更新できます。
UI_PKEY_LargeImage 無効化によってのみ更新できます。
UI_PKEY_SelectedItem(アイテム ギャラリーでのみ有効)
IUIFramework::GetUICommandPropertyIUIFramework::SetUICommandProperty をサポートします。
[!注]
IUIFramework::InvalidateUICommand の呼び出しによってコントロールに関連付けられているコマンドが無効になっている場合、フレームワークはフラグの値として渡されたときにUI_INVALIDATIONS_VALUEこのプロパティを照会します。

UI_PKEY_SmallHighContrastImage 無効化によってのみ更新できます。
UI_PKEY_SmallImage 無効化によってのみ更新できます。
UI_PKEY_TooltipDescription 無効化によってのみ更新できます。
UI_PKEY_TooltipTitle 無効化によってのみ更新できます。

SplitButtonGallery マークアップ要素

ギャラリーの操作

ギャラリーのサンプル