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

更新 : 2007 年 11 月

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

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

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

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

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

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