注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、グループ コントロールの種類に対する UI オートメーションのサポートについて説明します。 UI オートメーションでは、コントロール型は、 ControlTypeProperty プロパティを使用するためにコントロールが満たす必要がある一連の条件です。 条件には、UI オートメーション ツリー構造、UI オートメーション プロパティ値、および UI オートメーション コントロール パターンに関する特定のガイドラインが含まれます。
グループ コントロールは、階層内のノードを表します。 グループ コントロールの種類では、UI オートメーション ツリーで分離が作成されるため、グループ化された項目は UI オートメーション ツリー内で論理的に分割されます。
次のセクションでは、グループ コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれであっても、すべてのグループ コントロールに適用されます。
必要な UI オートメーション ツリー構造
次の表は、グループ コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「 UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| グループ - 0 または多数のコントロール |
グループ - 0 または多数のコントロール |
通常、グループ コントロールには、ListItem コントロール型の UI オートメーション サポート、TreeItem コントロール型の UI オートメーション サポート、またはサブツリーの下にある DataItem コントロール型コントロール型の UI オートメーション サポートがあります。 'Group' は汎用コンテナーであるため、任意の種類のコントロールがツリー内の Group コントロールの下に存在する可能性があります。
必要な UI オートメーション プロパティ
次の表に、グループ コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「 クライアントの UI オートメーション プロパティ」を参照してください。
| UI オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | ノートを参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| ClickablePointProperty | ノートを参照してください。 | 外接する四角形がある場合にサポートされます。 外接する四角形内のポイントのすべてがクリック可能でない場合、かつ特殊なヒットテストを行うのであれば、オーバーライドしてクリック可能なポイントを指定してください。 |
| IsKeyboardFocusableProperty | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | ノートを参照してください。 | 通常、グループ コントロールは、コントロールにラベルを付けるテキストからその名前を取得します。 |
| LabeledByProperty | ノートを参照してください。 | 通常、グループ コントロールは自己ラベル付けです。 このような場合は、ここで null を返します。 グループの静的テキスト ラベルがある場合は、LabeledBy プロパティの値として返す必要があります。 |
| ControlTypeProperty | グループ | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "group" | Group コントロール型に対応するローカライズされた文字列。 |
| IsContentElementProperty | 正しい | グループ コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。 |
| IsControlElementProperty | 正しい | 予定表グループは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
必要な UI オートメーション コントロール パターン
次の表に、グループ コントロールの種類でサポートするために必要な UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「 UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支援 | 注記 |
|---|---|---|
| IExpandCollapseProvider | 依存 | 情報の表示と非表示に使用できるグループ コントロールは、展開折りたたみパターンをサポートしている必要があります。 |
必要な UI オートメーション イベント
次の表に、すべてのグループ コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 支援 | 注記 |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| ExpandCollapseStateProperty プロパティ変更イベント。 | 依存 | 無し |
| ToggleStateProperty プロパティ変更イベント。 | 依存 | 無し |
| AutomationFocusChangedEvent | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |