次の方法で共有


チェック ボックス

チェック ボックスは、ユーザーがクリックしてアプリケーションに入力を提供できるコントロールです。 コントロールは、視覚的に表されるトグル状態を提供します。

説明

チェック ボックスは、3 次または不確定の状態をサポートしていません。

次のスクリーン ショットは、リボン チェック ボックス要素を示しています。

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

チェック ボックスのプロパティ

リボン フレームワークは、チェック ボックス コントロールの プロパティ キー のコレクションを定義します。

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

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

注意

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

次の表に、Check Box コントロールに関連付けられているプロパティ キーの一覧を示します。

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

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

CheckBox マークアップ要素