チェック ボックス
チェック ボックスは、ユーザーがクリックしてアプリケーションに入力を提供できるコントロールです。 コントロールは、視覚的に表されるトグル状態を提供します。
説明
チェック ボックスは、3 次または不確定の状態をサポートしていません。
次のスクリーン ショットは、リボン チェック ボックス要素を示しています。
チェック ボックスのプロパティ
リボン フレームワークは、チェック ボックス コントロールの プロパティ キー のコレクションを定義します。
通常、チェック ボックス プロパティは、 IUIFramework::InvalidateUICommand メソッドの呼び出しによってコントロールに関連付けられている Command を無効にすることで、リボン UI で更新されます。 無効化イベントが処理され、 IUICommandHandler::UpdateProperty コールバック メソッドによってプロパティが更新されます。
IUICommandHandler::UpdateProperty コールバック メソッドは実行されず、アプリケーションはフレームワークでプロパティが必要になるまで、更新されたプロパティ値を照会しました。 たとえば、タブがアクティブ化され、リボン UI に表示されるコントロールや、ツールヒントが表示されたときなどです。
注意
場合によっては、 IUIFramework::GetUICommandProperty メソッドを使用してプロパティを取得し、 IUIFramework::SetUICommandProperty メソッドで設定できます。
次の表に、Check Box コントロールに関連付けられているプロパティ キーの一覧を示します。
プロパティ キー | Notes |
---|---|
UI_PKEY_BooleanValue |
IUIFramework::GetUICommandProperty と IUIFramework::SetUICommandProperty をサポートします。
メモ: コントロールに関連付けられている Command が IUIFramework::InvalidateUICommand の呼び出しによって無効化された場合、フレームワークは フラグの値として が渡されたときに UI_INVALIDATIONS_VALUE このプロパティに対してクエリを実行 します。 |
UI_PKEY_Enabled | IUIFramework::GetUICommandProperty と IUIFramework::SetUICommandProperty をサポートします。 |
UI_PKEY_Keytip | 無効化によってのみ更新できます。 |
UI_PKEY_Label | 無効化によってのみ更新できます。 |
UI_PKEY_LabelDescription | 無効化によってのみ更新できます。 |
UI_PKEY_LargeHighContrastImage | 無効化によってのみ更新できます。 |
UI_PKEY_LargeImage | 無効化によってのみ更新できます。 |
UI_PKEY_SmallHighContrastImage | 無効化によってのみ更新できます。 |
UI_PKEY_SmallImage | 無効化によってのみ更新できます。 |
UI_PKEY_TooltipDescription | 無効化によってのみ更新できます。 |
UI_PKEY_TooltipTitle | 無効化によってのみ更新できます。 |