UI オートメーションによる Group コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、Group コントロール型での UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、UI オートメーションのコントロール パターンに関する特定のガイドラインが含まれます。
グループ コントロールは、階層内のノードを表します。 Group コントロール型では、UI オートメーション ツリーに区画を作成し、UI オートメーション ツリー内でグループとしてまとめられた項目が論理区画を持つようにします。
以降のセクションでは、Group コントロール型に必要な UI オートメーション ツリーの構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのグループ コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、グループ コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| Group - 0 個以上のコントロール |
Group - 0 個以上のコントロール |
通常、グループ コントロールでは、「UI オートメーションによる ListItem コントロール型のサポート」、「UI オートメーションによる Treeitem コントロール型のサポート」、または「UI オートメーションによる DataItem コントロール型のサポート」のコントロール型がサブツリー内のそれぞれの下に表示されます。 'Group' は汎用的なコンテナーであるため、任意の型のコントロールを、ツリーのグループ コントロールの下に配置できます。
必須の UI オートメーション プロパティ
次の表に、グループ コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | 通常、グループ コントロールの名前は、コントロールにラベル付けするテキストから取得されます。 |
| LabeledByProperty | 「ノート」を参照してください。 | 通常、グループ コントロールは、自動的にラベル付けされます。 ここでは、 null が返されます。 グループに静的なテキスト ラベルが存在する場合は、そのラベルを LabeledBy プロパティの値として返す必要があります。 |
| ControlTypeProperty | Group | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "group" | Group コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | ○ | このグループ コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。 |
| IsControlElementProperty | True | このカレンダー グループは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
必須の UI オートメーション コントロール パターン
次の表に、Group コントロール型でサポートされる必要がある UI オートメーションのコントロール パターンを示します。 コントロール パターンについて詳しくは、「 UI Automation Control Patterns Overview」をご覧ください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| IExpandCollapseProvider | 依存 | 情報の表示/非表示を切り替えるために使用するグループ コントロールは、Expand Collapse パターンをサポートする必要があります。 |
必須の UI オートメーション イベント
次の表に、すべてのグループ コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| ExpandCollapseStateProperty プロパティ変更イベント。 | 依存 | なし |
| ToggleStateProperty プロパティ変更イベント。 | 依存 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |