Drop-Down ギャラリー
Drop-Down ギャラリーは、クリックすると、相互に排他的な項目またはコマンドのコレクションを含むドロップダウン リストを表示するボタンで構成されます。
説明
このコントロールは、明らかな既定値がなく、個々の項目を画像、テキスト、またはその両方で表すことができる関連アイテムまたはコマンドを公開する場合に便利です。
垂直グリッパー バーとコーナー グリッパー バーの両方、またはハンドルのサイズ変更のサポートは、 DropDownGallery.MenuLayout 要素を通じて提供されます。
次のスクリーン ショットは、Microsoft ペイントのリボン Drop-Down ギャラリーを示しています。
Drop-Down ギャラリーのプロパティ
リボン フレームワークは、Drop-Down ギャラリー コントロールの プロパティ キー のコレクションを定義します。
通常、Drop-Down Gallery プロパティは、 IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられている Command を無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、 IUICommandHandler::UpdateProperty コールバック メソッドによって定義されたプロパティが更新されます。
IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションは、フレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブ化され、リボン UI にコントロールが表示されたときや、ツールヒントが表示されたときなどです。
注意
場合によっては、 IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、 IUIFramework::SetUICommandProperty メソッドを使用して設定できます。
次の表に、Drop-Down ギャラリー コントロールに関連付けられているプロパティ キーの一覧を示します。
| プロパティ キー | Notes |
|---|---|
| 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 をサポートします。
メモ：コントロールに関連付けられているコマンドが IUIFramework::InvalidateUICommand の呼び出しによって無効化された場合、フレームワークは フラグの値として が渡されたときにUI_INVALIDATIONS_VALUEこのプロパティを照会します。 |
| UI_PKEY_SmallHighContrastImage | 無効化によってのみ更新できます。 |
| UI_PKEY_SmallImage | 無効化によってのみ更新できます。 |
| UI_PKEY_TooltipDescription | 無効化によってのみ更新できます。 |
| UI_PKEY_TooltipTitle | 無効化によってのみ更新できます。 |