UI オートメーション Toggle コントロールパターンの実装

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、メソッドやプロパティに関する情報など、IToggleProvider を実装するガイドラインと規則について説明します。追加参照へのリンクはトピックの最後に示します。

TogglePattern コントロールパターンは、一連の状態を切り替え、1 回設定された状態を保持できるコントロールをサポートするために使用します。このコントロールパターンを実装するコントロールの例については、「UI オートメーションクライアントのコントロールパターンマッピング」を参照してください。

このトピックは、次のセクションで構成されています。

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

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

ボタン、ツールバーボタン、ハイパーリンクなど、アクティブになったときに状態を保持しないコントロールは、代わりに IInvokeProvider を実装する必要があります。
コントロールは、On、Off、および Indeterminate (サポートされている場合) の順に ToggleState を切り替える必要があります。
TogglePattern は、SetState(newState) メソッドを提供しません。これは、3 つの状態を持つ CheckBox を直接設定し、適切な ToggleState 順番で切り替えを行わない場合の問題のためです。
RadioButton コントロールは、有効な状態を切り替える機能がないため、IToggleProvider を実装しません。