次の方法で共有

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 プロパティ なし

このコントロール パターンには、関連するイベントがありません。

例外

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

関連項目