グループ (Windows リボン フレームワーク)
グループは、関連するコマンドとコントロールをタブ内に整理 します。
説明
次のスクリーン ショットは、リボン グループ コントロールを示しています。
グループ プロパティ
リボン フレームワークは、Group コントロールの プロパティ キー のコレクションを定義します。
通常、グループ プロパティは、 IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられている Command を無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、 IUICommandHandler::UpdateProperty コールバック メソッドによってプロパティが更新されます。
IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションはフレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブ化され、リボン UI に表示されるコントロールや、ツールヒントが表示されたときなどです。
注意
場合によっては、 IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、 IUIFramework::SetUICommandProperty メソッドで設定できます。
次の表に、Group コントロールに関連付けられているプロパティ キーの一覧を示します。
| プロパティ キー | Notes |
|---|---|
| UI_PKEY_Keytip | 無効化によってのみ更新できます。
メモ： フレームワークでは、Group コントロールの UI_PKEY_Keytip の値が大文字の Z で始まる必要があります。 IUICommandHandler::UpdateProperty コールバック メソッドでアプリケーションによって指定された値が文字 Z で始まらない場合、この値は無視され、代わりにフレームワークによって値が生成されます。 フレームワーク値は、文字 Z の後に、後続の Group コントロール (Z1、Z2、...、Zx) に対して、1 から始まり、必要に応じて順番に増加する数値です。 |
| UI_PKEY_Label | 無効化によってのみ更新できます。 |
| UI_PKEY_LargeHighContrastImage | 無効化によってのみ更新できます。 |
| UI_PKEY_LargeImage | 無効化によってのみ更新できます。 |
| UI_PKEY_SmallHighContrastImage | 無効化によってのみ更新できます。 |
| UI_PKEY_SmallImage | 無効化によってのみ更新できます。 |
| UI_PKEY_TooltipDescription | 無効化によってのみ更新できます。 |
| UI_PKEY_TooltipTitle | 無効化によってのみ更新できます。 |