次の方法で共有

HeaderItem コントロール型

  • [アーティクル]

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

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

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

このトピックには、次のセクションが含まれています。

一般的なツリー構造

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

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

 

関連するプロパティ

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

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

 

必要なコントロール パターン

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

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

 

必要なイベント

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

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

 

概念

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

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