UI オートメーションによる Group コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、UI Automationによる Group コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびUI Automation コントロール パターンに関する特定のガイドラインが含まれます。
グループ コントロールは、階層内のノードを表します。 Group コントロール型は、UI Automation ツリー内に分離を作成し、グループ化された項目が UI Automation ツリー内で論理的に分割されるようにします。
以下のセクションでは、Group コントロール型で必要な UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのグループ コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表に、グループ コントロールに関連する UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
グループ
|
グループ
|
通常、グループ コントロールの下のサブツリーには、UI オートメーションによる ListItem コントロール型のサポート、UI オートメーションによる TreeItem コントロール型のサポート、またはUI オートメーションによる DataItem コントロール型のサポートのコントロール型があります。 "Group" は汎用的なコンテナーなので、任意の種類のコントロールをツリー内で Group コントロールの下に置くことができます。
必須の UI オートメーション プロパティ
値または定義がグループ コントロールに特に関連する UI Automationのプロパティの一覧を次の表に示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
通常、グループ コントロールの名前は、コントロールにラベルを付けるテキストから取得されます。 |
|
説明を参照。 |
通常、グループ コントロールには自動的にラベルが付けられます。 その場合、ここでは null が返されます。 グループに静的なテキスト ラベルがある場合は、LabeledBy プロパティの値としてそれが返される必要があります。 |
|
グループ |
この値は、すべての UI フレームワークで共通です。 |
|
"グループ" |
Group コントロール型に対応するローカライズされた文字列。 |
|
True |
グループ コントロールは、常に UI Automation ツリーのコンテンツ ビューに含まれます。 |
|
True |
グループ コントロールは、常に UI Automation ツリーのコントロール ビューに含まれます。 |
必須の UI オートメーション コントロール パターン
Group コントロール型でサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン |
サポート |
説明 |
|---|---|---|
依存 |
情報の表示または非表示に使用できるグループ コントロールは、展開/折りたたみパターンをサポートする必要があります。 |
必須の UI オートメーション イベント
すべてのグループ コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート |
説明 |
|---|---|---|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
ExpandCollapseStateProperty プロパティ変更イベント |
依存 |
なし |
ToggleStateProperty プロパティ変更イベント |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |