ヘッダー コントロールの種類
このトピックでは、ヘッダー コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。
ヘッダー コントロールは、情報の行または列のラベルのためのビジュアル コンテナーを提供します。
次のセクションでは、Header コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーション要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのヘッダー コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、ヘッダー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
(該当なし) |
ヘッダー コントロールは常に、UI オートメーション ツリーのコントロール ビューに 1 つ以上の子を持ちます。
UI オートメーション ツリーのコンテンツ ビューには、ヘッダー コントロールの子は 0 あります。
関連するプロパティ
次の表に、ヘッダー コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。
| UI Automation のプロパティ | 値 | メモ |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。 |
| UIA_ControlTypePropertyId | Header | |
| UIA_IsContentElementPropertyId | FALSE | このヘッダー コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。 |
| UIA_IsControlElementPropertyId | true | このヘッダー コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | NULL | ヘッダー コントロールに静的ラベルはありません。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 | 既定値は、en-US または英語 (米国) の "ヘッダー" です。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | 複数の行ヘッダーまたは複数の列ヘッダーがある場合、ヘッダー コントロールには名前が必要です。 これにより、ヘッダー内の情報を識別します。 |
| UIA_OrientationPropertyId | OrientationType_Horizontal または OrientationType_Vertical | このプロパティの値は、行ヘッダー (OrientationType_Horizontal) または列ヘッダー (OrientationType_Vertical) のいずれであるかに関係なく、ヘッダー コントロールの位置を公開します。 |
必須のコントロール パターン
次の表に、ヘッダー コントロールでサポートするために必要なUI オートメーションコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| ITransformProvider | 依存 | ヘッダー コントロールのサイズを変更できる場合は、 Transform コントロール パターンを実装します。 |
必須イベント
次の表に、ヘッダー コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | メモ |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。 | |
| プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_StructureChangedEventId |
関連トピック