注
このドキュメントは、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 オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | 外接する四角形がある場合にサポートされます。 外接する四角形内のポイントのすべてがクリック可能でない場合、かつ特殊なヒットテストを行うのであれば、オーバーライドしてクリック可能なポイントを指定してください。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | ヘッダー項目コントロールは常に自己ラベル付けです。 |
| LabeledByProperty |
Null。 |
ヘッダー項目コントロールには静的ラベルがありません。 |
| ControlTypeProperty | HeaderItem | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "ヘッダー項目" | HeaderItem コントロール型のローカライズされた文字列。 |
| IsContentElementProperty | いいえ | ヘッダー項目コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。 |
| IsControlElementProperty | 正しい | ヘッダー項目コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
| ItemStatusProperty | 「ノート」を参照してください。 | このプロパティは、ヘッダー項目による並べ替え順序に関する情報を提供します。 |
必要な UI オートメーション コントロール パターン
次の表に、すべてのヘッダー項目コントロールでサポートされる必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支援 | 注記 |
|---|---|---|
| ITransformProvider | 依存 | ヘッダー項目コントロールのサイズを変更できる場合は、このコントロール パターンを実装します。 |
| IInvokeProvider | 依存 | ヘッダー項目コントロールをクリックしてデータを並べ替えることができる場合は、このコントロール パターンを実装します。 |
必要な UI オートメーション イベント
次の表に、すべてのヘッダー項目コントロールでサポートされる必要がある UI オートメーション イベントの一覧を示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 支援 | 注記 |
|---|---|---|
| InvokedEvent | 依存 | 無し |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| AutomationFocusChangedEvent | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |