ヘッダー コントロールの種類

  • [アーティクル]

このトピックでは、ヘッダー コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。

ヘッダー コントロールは、情報の行または列のラベルのためのビジュアル コンテナーを提供します。

次のセクションでは、Header コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーション要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのヘッダー コントロールに適用されます。

このトピックは、次のセクションで構成されています。

一般的なツリー構造

次の表は、ヘッダー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • ヘッダー
    • HeaderItem (1 個以上)
 (該当なし)

 

ヘッダー コントロールは常に、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

 

概念

UI オートメーション コントロール型の概要

UI オートメーションの概要