更新 : 2007 年 11 月
ここでは、UI オートメーションによる Header コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
ヘッダー コントロールは、情報の行または列のラベルに対するビジュアル コンテナを提供します。
以下のセクションでは、Header コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのヘッダー コントロールに当てはまります。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、ヘッダー コントロールに関連した UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
なし |
ヘッダー コントロールは、UI オートメーション ツリーのコントロール ビュー内に、常に 1 つ以上の子を持ちます。
ヘッダー コントロールは、UI オートメーション ツリーのコンテンツ ビュー内に 0 個の子を持ちます。
必須の UI オートメーション プロパティ
値または定義がヘッダー コントロールに特に関連する UI オートメーションのプロパティのリストを次の表に示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
説明 |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
行ヘッダーまたは列ヘッダーが複数存在する場合、ヘッダー コントロールには名前が必要です。これにより、ヘッダー内の情報が識別されます。 |
|
Null. |
ヘッダー コントロールには静的なラベルはありません。 |
|
Header |
この値は、すべての UI フレームワークで共通です。 |
|
"ヘッダー" |
この値は、すべての UI フレームワークで共通です。 |
|
Horizontal |
このプロパティの値は、ヘッダー コントロール (行ヘッダーおよび列ヘッダーのどちらでも) の位置を公開します。 |
|
False |
ヘッダー コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。 |
|
True |
ヘッダー コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
必須の UI オートメーション コントロール パターン
すべてのヘッダー コントロールによるサポートが必要な UI オートメーション コントロール パターンのリストを次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
依存 |
ヘッダー コントロールのサイズを変更できる場合は、このコントロール パターンを実装します。 |
必須の UI オートメーション イベント
すべてのヘッダー コントロールによるサポートが必要な UI オートメーション イベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
説明 |
|---|---|---|
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
必須 |
なし |
|
必須 |
なし |