注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、メソッドとプロパティに関する情報など、 IToggleProviderを実装するためのガイドラインと規則について説明します。 その他の参照へのリンクは、トピックの最後に一覧表示されます。
TogglePattern コントロール パターンは、一連の状態を循環し、一度設定すると状態を維持できるコントロールをサポートするために使用されます。 このコントロール パターンを実装するコントロールの例については、「UI オートメーション クライアントのコントロール パターン マッピング 」を参照してください。
実装のガイドラインと規則
Toggle コントロール パターンを実装する場合は、次のガイドラインと規則に注意してください。
ボタン、ツール バー ボタン、ハイパーリンクなど、アクティブ化時に状態を維持しないコントロールは、代わりに IInvokeProvider を実装する必要があります。
コントロールは、ToggleState、On、サポートされている場合はOffの順序でIndeterminateを循環する必要があります。
TogglePattern には、トライステート CheckBox を適切な ToggleState シーケンスを通さずに直接設定することに関する問題があるため、SetState(newState) メソッドが提供されていません。
RadioButton コントロールは、有効な状態を循環できないので、 IToggleProviderを実装しません。
IToggleProvider の必須メンバー
IToggleProviderの実装には、次のプロパティとメソッドが必要です。
| 必須メンバー | メンバーの種類 | 注記 |
|---|---|---|
| Toggle | メソッド | 無し |
| ToggleStateProperty | プロパティ | 無し |
このコントロール パターンには、関連付けられたイベントはありません。
例外
このコントロール パターンには、例外が関連付けされません。