In-Ribbon ギャラリー

In-Ribbon ギャラリーは、リボンの関連アイテムまたはコマンドのコレクションを表示するコントロールです。 ギャラリーにアイテムが多すぎる場合は、展開されたウィンドウにコレクションの残りの部分を表示するための展開矢印が表示されます。

• 詳細
• リボン内ギャラリーのプロパティ
• 関連トピック

説明

次のスクリーン ショットは、Microsoft ペイントのリボン In-Ribbon ギャラリー コントロールを示しています。

In-Ribbon ギャラリーのプロパティ

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

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

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

注意

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

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

プロパティ キー	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 をサポートします。 メモ： コントロールに関連付けられている Command が IUIFramework::InvalidateUICommand の呼び出しによって無効化された場合、フレームワークは フラグの値として が渡されたときに UI_INVALIDATIONS_VALUE このプロパティに対してクエリを実行 します。
UI_PKEY_SmallHighContrastImage	無効化によってのみ更新できます。
UI_PKEY_SmallImage	無効化によってのみ更新できます。
UI_PKEY_TooltipDescription	無効化によってのみ更新できます。
UI_PKEY_TooltipTitle	無効化によってのみ更新できます。

関連トピック

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

InRibbonGallery 要素

ギャラリーの操作

ギャラリーのサンプル