HeaderItem コントロールの種類

  • [アーティクル]

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

HeaderItem コントロール型は、情報の行または列のビジュアル ラベルを提供します。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • HeaderItem
 (該当なし)

 

関連するプロパティ

次の表に、値または定義が HeaderItem コントロール型に特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。

UI Automation のプロパティ 値 Notes
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId HeaderItem この値は、すべての UI フレームワークで同じです。
UIA_IsContentElementPropertyId FALSE このヘッダー項目コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。
UIA_IsControlElementPropertyId true このヘッダー項目コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_ItemStatusPropertyId メモを参照 このプロパティは、ヘッダー項目による並べ替え順序の情報を提供します。
UIA_LabeledByPropertyId NULL ヘッダー項目コントロールには、静的テキスト ラベルがありません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 HeaderItem コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ヘッダー項目" です。
UIA_NamePropertyId 「ノート」を参照してください。 ヘッダー項目コントロールは、常に自己ラベル付けを行います。

 

必須のコントロール パターン

次の表に、すべてのヘッダー項目コントロールでサポートされる必要がある UI オートメーションのコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロール パターン サポート Notes
IInvokeProvider 依存 ヘッダー項目コントロールをクリックしてデータを並べ替えることができる場合は、 Invoke コントロール パターンを実装します。
ITransformProvider 依存 ヘッダー項目コントロールのサイズを変更できる場合は、 Transform コントロール パターンを実装します。

 

必須イベント

次の表に、ヘッダー項目コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。

UI オートメーション イベント Notes
UIA_AutomationFocusChangedEventId
プロパティ変更イベントUIA_BoundingRectanglePropertyId 。
UIA_Invoke_InvokedEventId コントロールが Invoke コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_IsEnabledPropertyId。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_IsOffscreenPropertyId。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

概念

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

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