トグル ボタン

  • [アーティクル]

クリックした場合のトグル ボタンは、アプリケーションへの入力を提供します。 コントロールは、相互に排他的なトグル状態を表します。

説明

次のスクリーン ショットは、リボンの切り替えボタンを示しています。

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

トグル ボタンのプロパティ

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

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

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

注意

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

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

プロパティ キー Notes
UI_PKEY_BooleanValue IUIFramework::GetUICommandProperty と IUIFramework::SetUICommandProperty をサポートします。 メモ：コントロールに関連付けられているコマンドが 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 無効化によってのみ更新できます。

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

ToggleButton マークアップ要素