UI オートメーションによる HeaderItem コントロール型のサポート

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

このトピックでは、UI Automationによる HeaderItem コントロール型のサポートについての情報を提供します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

HeaderItem コントロール型は、情報の行または列に視覚的なラベルを提供します。

HeaderItem コントロール型を実装するコントロールとして、ヘッダー項目コントロールなどがあります。 次のセクションで説明する UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのヘッダー コントロールに当てはまります。

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

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

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

コントロール ビュー	コンテンツ ビュー
HeaderItem	なし

必須の UI オートメーション プロパティ

次の表に、値または定義が特にヘッダー項目コントロールに関連する UI Automation プロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI Automation プロパティ	値	説明
AutomationIdProperty	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	説明を参照。	コントロール全体を包含する外側の四角形。
ClickablePointProperty	説明を参照。	外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。
IsKeyboardFocusableProperty	説明を参照。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	説明を参照。	ヘッダー項目コントロールには、常に自動的にラベルが付けられます。
LabeledByProperty	Null.	ヘッダー項目コントロールには静的なラベルはありません。
ControlTypeProperty	HeaderItem	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"ヘッダー項目"	HeaderItem コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	False	ヘッダー項目コントロールは、UI Automation ツリーのコンテンツ ビューには含まれません。
IsControlElementProperty	True	ヘッダー項目コントロールは、UI Automation ツリーのコントロール ビューに常に含まれます。
ItemStatusProperty	説明を参照。	このプロパティは、ヘッダー項目による並べ替え順序に関する情報を提供します。

必須の UI オートメーション コントロール パターン

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

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

必須の UI オートメーション イベント

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

UI Automation イベント	サポート	説明
InvokedEvent	依存	なし
BoundingRectangleProperty プロパティ変更イベント	必須	なし
IsOffscreenProperty プロパティ変更イベント	必須	なし
IsEnabledProperty プロパティ変更イベント	必須	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

参照

HeaderItem

概念

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

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