DataGrid コントロールの種類

[アーティクル]
06/13/2023

このトピックでは、DataGrid コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。

DataGrid コントロール型を使用すると、ユーザーは列または行に表示されるデータ要素またはオートメーション要素を含む項目を簡単に操作できます。データグリッドコントロールでは、項目の行と、それらの項目に関する情報の列があります。 Windows Vista エクスプローラーのリストビューコントロールは、DataGrid コントロールの種類をサポートする例です。

次のセクションでは、DataGrid コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロールパターン、およびイベントを定義します。 UI オートメーション要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロールパターンのサポートUI オートメーション統合するすべてのデータグリッドコントロールに適用されます。

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

一般的なツリー構造
関連するプロパティ
必須のコントロールパターン
必須イベント
DataGrid コントロールの種類の例
関連トピック

一般的なツリー構造

次の表は、データグリッドコントロールに関連するUI オートメーションツリーの一般的なコントロールとコンテンツビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーションツリーの詳細については、「UI オートメーションツリーの概要」を参照してください。

コントロールビュー	コンテンツビュー
DataGrid Header (0、1、または 2) HeaderItem (列または行の数) DataItem (0 以上。階層内で構造化できます)	DataGrid DataItem (0 以上。階層内で構造化できます)

関連するプロパティ

次の表に、値または定義が DataGrid コントロール型に特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。

UI Automation のプロパティ	値	Notes
UIA_AutomationIdPropertyId	「ノート」を参照してください。	このプロパティの値は、UI オートメーションツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId	「ノート」を参照してください。	コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId	「ノート」を参照してください。	四角形領域が存在する場合にサポートされます。外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒットテストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId	DataGrid
UIA_IsContentElementPropertyId	true	このプロパティの値は常に TRUE である必要があります。つまり、データグリッドコントロールが常に UI オートメーションツリーのコンテンツビューに存在している必要があります。
UIA_IsControlElementPropertyId	true	このプロパティの値は常に TRUE である必要があります。つまり、データグリッドコントロールは常に、UI オートメーションツリーのコントロールビューに含める必要があります。
UIA_IsKeyboardFocusablePropertyId	「ノート」を参照してください。	コントロールがキーボードフォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId	「ノート」を参照してください。	静的テキストラベルがある場合、このプロパティは、そのコントロールへの参照を公開する必要があります。
UIA_LocalizedControlTypePropertyId	「ノート」を参照してください。	DataGrid コントロール型に対応するローカライズされた文字列。既定値は、en-US または英語 (米国) の "データグリッド" です。
UIA_NamePropertyId	「ノート」を参照してください。	通常、データグリッドコントロールは、静的テキストラベルから Name プロパティの値を取得します。静的なテキストラベルがない場合、アプリケーション開発者は Name プロパティのに値を割り当てる必要があります。 Name プロパティの値は、編集コントロールのテキストコンテンツにすることはできません。

必須のコントロールパターン

次の表に、すべてのデータグリッドコントロールでサポートするために必要なUI オートメーションコントロールパターンを示します。コントロールパターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロールパターン	サポート	Notes
IGridProvider	必須	データグリッドコントロール自体は常に Grid コントロールパターンをサポートします。これは、そのコントロールに含まれる項目にグリッドにレイアウトされたメタデータがあるためです。
IScrollProvider	依存	データグリッドをスクロールする機能はコンテンツ、およびスクロールバーが存在するかどうかによって異なります。
ISelectionProvider	依存	データグリッドを選択する機能は、コンテンツに依存します。
ITableProvider	依存	ヘッダーを持つデータグリッドコントロールは、 Table コントロールパターンをサポートする必要があります。

データグリッドコンテナー内のデータ項目は、少なくとも次をサポートします。

SelectionItem コントロールパターン (データグリッドが選択可能な場合)
ScrollItem コントロールパターン (データグリッドがスクロール可能な場合)
GridItem コントロールパターン
TableItem コントロールパターン (データグリッドにヘッダーがある場合)

必須イベント

次の表に、データグリッドコントロールがサポートするために必要なUI オートメーションイベントの一覧を示します。イベントの詳細については、「 UI Automation Events Overview」を参照してください。

UI オートメーションイベント	Notes
UIA_AutomationFocusChangedEventId
プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。
プロパティUIA_IsEnabledPropertyId 変更されたイベントです。	コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。	コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_LayoutInvalidatedEventId
UIA_StructureChangedEventId
プロパティ変更イベントUIA_MultipleViewCurrentViewPropertyId します。	コントロールが MultipleView コントロールパターンの CurrentView プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollHorizontallyScrollablePropertyId します。	コントロールが Scroll コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollHorizontalScrollPercentPropertyId します。	コントロールが Scroll コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_ScrollHorizontalViewSizePropertyId 変更されたイベントです。	コントロールが Scroll コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ScrollVerticalScrollPercentPropertyId します。	コントロールが Scroll コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_ScrollVerticallyScrollablePropertyId 変更されたイベントです。	コントロールが Scroll コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_ScrollVerticalViewSizePropertyId 変更されたイベントです。	コントロールが Scroll コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA_Selection_InvalidatedEventId