UI オートメーションによる CheckBox コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、CheckBox コントロール型に対する Microsoft UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
チェック ボックスは、ユーザーが対話的にその状態を循環させることが可能な状態を示すために使用されるオブジェクトです。 チェック ボックスでは、2 項 (はい/いいえ)、(オン/オフ) または 3 項 (オン/オフ、不定) のいずれかのオプションをユーザーに提示できます。
以降のセクションでは、CheckBox コントロール型に必要な UI オートメーション ツリーの構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのチェック ボックス コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、チェック ボックス コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| CheckBox | CheckBox |
Note
チェック ボックスは、コントロールやコンテンツ ビュー内に子要素を持つことはありません。 コントロールに子要素を入れる必要があるのであれば、それは別のコントロール型を使用する必要があるということです。
必須の UI オートメーション プロパティ
次の表に、チェック ボックス コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。 |
| ControlTypeProperty | CheckBox | この値は、すべての UI フレームワークで同じです。 |
| IsContentElementProperty | ○ | このプロパティの値は、常に True にする必要があります。 つまり、チェック ボックス コントロールが常に UI オートメーション ツリーのコンテンツ ビューに含まれている必要があります。 |
| IsControlElementProperty | ○ | このプロパティの値は、常に True にする必要があります。 つまり、チェック ボックス コントロールが常に UI オートメーション ツリーのコントロール ビューに含まれている必要があります。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| LabeledByProperty | Null |
チェック ボックスはそれ自体がラベルであるコントロールです。 |
| LocalizedControlTypeProperty | "チェック ボックス" | CheckBox コントロール型に対応する、ローカライズされた文字列。 |
| NameProperty | 「ノート」を参照してください。 | チェック ボックス コントロールの Name プロパティの値は、切り替えの状態を保持するボックスの横に表示されるテキストです。 |
必須の UI オートメーション コントロール パターン
次の表に、すべてのチェック ボックス コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンについて詳しくは、「 UI Automation Control Patterns Overview」をご覧ください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| IToggleProvider | 必須 | チェック ボックスで、プログラムを使用して内部の状態をいつでも循環できるようにします。 |
必須の UI オートメーション イベント
次の表に、すべてのチェック ボックス コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| AutomationFocusChangedEvent | 必須 | なし |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| StructureChangedEvent | 必須 | なし |
| ToggleStateProperty プロパティ変更イベント。 | 必須 | なし |
既定の動作
チェック ボックスの既定の動作では、ラジオ ボタンにフォーカスが設定されて、その現在の状態を切り替えます。 前述のように、チェック ボックスでは、2 項 (はい/いいえ)、(オン/オフ) または 3 項 (オン/オフ、不定) のいずれかの決定項目をユーザーに提示します。 チェック ボックスが 2 項の場合、既定の動作では、「オン」の状態が「オフ」になり、「オフ」の状態が「オン」になります。 3 項のチェック ボックスで、既定の動作では、ユーザーがコントロールに連続するマウス クリックを送信した場合と同じ順序で、チェック ボックスの状態を切り替えます。