UI オートメーションによる HeaderItem コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、HeaderItem コントロール型での UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
HeaderItem コントロール型は、情報の行または列のビジュアル ラベルを提供します。
HeaderItem コントロール型を実装するコントロールの例には、ヘッダー項目コントロールがあります。 以下のセクションの UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのヘッダー コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、ヘッダー項目コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| HeaderItem | なし |
必須の UI オートメーション プロパティ
次の表に、ヘッダー項目コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | ヘッダー項目コントロールは、常に自己ラベル付けを行います。 |
| LabeledByProperty | Null。 |
ヘッダー項目コントロールに静的ラベルはありません。 |
| ControlTypeProperty | HeaderItem | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | 「ヘッダー項目」 | HeaderItem コントロール型のローカライズされた文字列。 |
| IsContentElementProperty | × | このヘッダー項目コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。 |
| IsControlElementProperty | True | このヘッダー項目コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
| ItemStatusProperty | 「ノート」を参照してください。 | このプロパティは、ヘッダー項目による並べ替え順序の情報を提供します。 |
必須の UI オートメーション コントロール パターン
次の表に、すべてのヘッダー項目コントロールでサポートされる必要がある UI オートメーションのコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| ITransformProvider | 依存 | ヘッダー項目コントロールのサイズを変更できる場合は、このコントロール パターンを実装します。 |
| IInvokeProvider | 依存 | ヘッダー項目コントロールをクリックしてデータを並べ替えることができる場合は、このコントロール パターンを実装します。 |
必須の UI オートメーション イベント
次の表に、すべてのヘッダー項目コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| InvokedEvent | 依存 | なし |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |