CheckBox コントロールの種類
このトピックでは、CheckBox コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。
チェック ボックスは、ユーザーが操作してその状態を循環できる状態を示すために使用されるオブジェクトです。 チェック ボックスには、バイナリ (はい/いいえ)、(オン/オフ)、または 3 次 (オン、オフ、不確定) オプションがユーザーに表示されます。
次のセクションでは、CheckBox コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのチェック ボックス コントロールに適用されます。
このトピックには、次のセクションが含まれています。
- 一般的なツリー構造の
- 関連するプロパティ を する
- 必要なコントロール パターンの
- 必要なイベント を する
- DefaultAction の
- 関連トピック
一般的なツリー構造
次の表は、チェック ボックス コントロールに関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
関連するプロパティ
次の表に、CheckBox コントロール型に特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。
| UI オートメーション プロパティ | 価値 | 筆記 |
|---|---|---|
| UIA_AutomationIdPropertyId | ノートを参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| UIA_ClickablePointPropertyId | ノートを参照してください。 | 外接する四角形がある場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。 |
| UIA_ControlTypePropertyId | CheckBox を する | |
| UIA_IsContentElementPropertyId | 真 | このプロパティの値は常に TRUE する必要があります。 つまり、チェック ボックス コントロールは常に UI オートメーション ツリーのコンテンツ ビューに含める必要があります。 |
| UIA_IsControlElementPropertyId | 真 | このプロパティの値は常に TRUE する必要があります。 つまり、チェック ボックス コントロールは常に UI オートメーション ツリーのコントロール ビューに含める必要があります。 |
| UIA_IsKeyboardFocusablePropertyId | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | ヌル | チェック ボックス コントロールは自己ラベル付けです。 |
| UIA_LocalizedControlTypePropertyId | ノートを参照してください。 | CheckBox コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "チェック ボックス" です。 |
| UIA_NamePropertyId | ノートを参照してください。 | チェック ボックス コントロールの IUIAutomationElement::CurrentName (または CachedName) プロパティの値は、トグル状態を維持するボックスの横に表示されるテキストです。 |
必要なコントロール パターン
次の表に、すべてのチェック ボックス コントロールでサポートされる必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
| Control Pattern/Pattern プロパティ | サポート/値 | 筆記 |
|---|---|---|
| IToggleProviderの | 必須 | チェック ボックスは、トグル コントロール パターンをサポートし、チェック ボックスをプログラムで内部状態に切り替えることができます。 |
必要なイベント
次の表に、チェック ボックス コントロールをサポートするために必要な UI オートメーション イベントを示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 筆記 |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| プロパティ変更イベント UIA_BoundingRectanglePropertyId します。 | |
| プロパティ変更イベント UIA_IsOffscreenPropertyId します。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティ変更イベントを UIA_IsEnabledPropertyId します。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_StructureChangedEventId | |
| プロパティ UIA_ToggleToggleStatePropertyId 変更されたイベントです。 |
DefaultAction
チェック ボックスの既定のアクションは、ラジオ ボタンがフォーカスされ、現在の状態を切り替える操作です。 前述のように、チェック ボックスは、バイナリ (はい/いいえまたはオン/オフ) の決定をユーザーまたは 3 次 (オン、オフ、不確定) を示します。 チェック ボックスがバイナリの場合、既定のアクションによって "on" 状態が "off" になるか、"off" 状態が "on" になります。 3 番目のチェック ボックスでは、既定のアクションは、ユーザーが連続してマウス クリックをコントロールに送信した場合と同じ順序でチェック ボックスの状態を循環します。
関連トピック