次の方法で共有


In-Ribbon ギャラリー

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

説明

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

Microsoft ペイント リボンの inribbongallery コントロールのスクリーン ショット。

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

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

InRibbonGallery 要素

ギャラリーの操作

ギャラリーのサンプル