コントロールパターンの切り替え

プロパティとメソッドに関する情報など、IToggleProvider実装するためのガイドラインと規則について説明します。 トグル コントロールパターンは、一連の状態を循環し、一度設定した状態を維持できるコントロールをサポートするために使用されます。

このコントロールパターンを実装するコントロールの例については、「コントロールの種類とサポートされるコントロールパターンの」を参照してください。

このトピックには、次のセクションが含まれています。

実装のガイドラインと規則

トグル コントロールパターンを実装する場合は、次のガイドラインと規則に注意してください。

ボタン、ツールバーボタン、ハイパーリンクなど、アクティブ化時に状態を維持しないコントロールは、代わりに IInvokeProvider実装する必要があります。
コントロールは、トグル状態 (ToggleState) を次の順序で切り替える必要があります。ToggleState_On、ToggleState_Off、サポートされている場合は ToggleState_Indeterminate。
Toggle では、適切な ToggleState シーケンスを循環せずに、3 状態チェックボックスの直接設定に関する問題があるため、set-state メソッドは提供されません。
IToggleProvider、有効な状態を循環できないため、ラジオボタンコントロールは実装しません。

IToggleProvider インターフェイスを実装する場合は、次のプロパティとメソッドが必要です。

必須メンバー	メンバーの種類	筆記
の切り替え	方式	何一つ
ToggleState	財産	何一つ

このコントロールパターンには、関連付けられたイベントはありません。