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