ヘッダー コントロールの種類
このトピックでは、ヘッダー コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。
ヘッダー コントロールは、情報の行または列のラベルのビジュアル コンテナーを提供します。
次のセクションでは、Header コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのヘッダー コントロールに適用されます。
このトピックには、次のセクションが含まれています。
- 一般的なツリー構造の
- 関連するプロパティ を する
- 必要なコントロール パターンの
- 必要なイベント を する
- 関連トピック
一般的なツリー構造
次の表は、ヘッダー コントロールに関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー | コンテンツ ビュー |
---|---|
|
(該当なし) |
ヘッダー コントロールは、UI オートメーション ツリーのコントロール ビューに常に 1 つ以上の子を持ちます。
ヘッダー コントロールには、UI オートメーション ツリーのコンテンツ ビューに子が 0 個含まれています。
関連するプロパティ
次の表に、ヘッダー コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。
UI オートメーション プロパティ | 価値 | 筆記 |
---|---|---|
UIA_AutomationIdPropertyId | ノートを参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
UIA_BoundingRectanglePropertyId | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
UIA_ClickablePointPropertyId | ノートを参照してください。 | 外接する四角形がある場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。 |
UIA_ControlTypePropertyId | ヘッダー | |
UIA_IsContentElementPropertyId | 偽 | ヘッダー コントロールは、UI オートメーション ツリーのコンテンツ ビューには含まれません。 |
UIA_IsControlElementPropertyId | 真 | ヘッダー コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
UIA_IsKeyboardFocusablePropertyId | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
UIA_LabeledByPropertyId | ヌル | ヘッダー コントロールには静的ラベルがありません。 |
UIA_LocalizedControlTypePropertyId | ノートを参照してください。 | 既定値は、en-US または英語 (米国) の場合は "header" です。 |
UIA_NamePropertyId | ノートを参照してください。 | 複数の行ヘッダーまたは複数の列ヘッダーがある場合、ヘッダー コントロールには名前が必要です。 これにより、ヘッダー内の情報が識別されます。 |
UIA_OrientationPropertyId | OrientationType_Horizontal または OrientationType_Vertical | このプロパティの値は、行ヘッダー (OrientationType_Horizontal) または列ヘッダー (OrientationType_Vertical) のいずれであるかに関係なく、ヘッダー コントロールの位置を公開します。 |
必要なコントロール パターン
次の表に、ヘッダー コントロールでサポートする必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン | 支える | 筆記 |
---|---|---|
ITransformProviderの | 依存 | ヘッダー コントロールのサイズを変更できる場合は、Transform コントロール パターンを実装します。 |
必要なイベント
次の表に、ヘッダー コントロールがサポートするために必要な UI オートメーション イベントを示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント | 筆記 |
---|---|
UIA_AutomationFocusChangedEventId | |
プロパティ変更イベント UIA_BoundingRectanglePropertyId します。 | |
プロパティ変更イベントを UIA_IsEnabledPropertyId します。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
プロパティ変更イベント UIA_IsOffscreenPropertyId します。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
UIA_StructureChangedEventId |
関連トピック