UI オートメーション Toggle コントロール パターンの実装
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、メソッドおよびプロパティに関する情報など、 IToggleProviderの実装のためのガイドラインと規則について説明します。 その他のリファレンスへのリンクは、トピックの最後に記載します。
TogglePattern コントロール パターンは、一連の状態を順番に繰り返し、状態を一度設定したらそれを保持できるコントロールをサポートするために使用します。 このコントロール パターンを実装するコントロールの例については、「 Control Pattern Mapping for UI Automation Clients」をご覧ください。
実装のガイドラインと規則
Toggle コントロール パターンを実装する場合は、次のガイドラインと規則にご留意ください。
ボタン、ツール バー ボタン、ハイパーリンクなど、アクティブになったときに状態を保持しないコントロールは、代わりに IInvokeProvider を実装する必要があります。
コントロールは、 ToggleState 、 On、 Off (サポートされている場合) の順にその Indeterminateを繰り返す必要があります。
TogglePattern は、SetState(newState) メソッドを提供しません。これは、適切な ToggleState の順番の繰り返しをせずに、3 つの状態を持つ CheckBox を直接設定することに関連する問題のためです。
RadioButton コントロールは IToggleProviderを実装しません。これは、その正しい状態を順番に繰り返す機能がないためです。
IToggleProvider の必須メンバー
IToggleProviderの実装には、次のプロパティとメソッドが必要です。
| 必須メンバー | メンバーの型 | メモ |
|---|---|---|
| Toggle | 方法 | なし |
| ToggleStateProperty | プロパティ | なし |
このコントロール パターンには、関連するイベントがありません。
例外
このコントロール パターンに関連付けられた例外はありません。