グループ コントロールの種類

  • [アーティクル]

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

グループ コントロールは、階層内のノードを表します。 グループ 化コントロールの種類では、UI オートメーション ツリーに分離が作成されるため、グループ化された項目には、UI オートメーション ツリー内に論理除算が含まれます。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • Group
    • 0 以上のコントロール
  • グループ
    • 0 以上のコントロール

 

通常、グループ コントロールには、ListItem、TreeItem、DataItem コントロール型など、サブツリー内の下にあるコントロール型のUI オートメーションサポートが含まれます。 グループ コントロールは汎用コンテナーであるため、任意の種類のコントロールがツリー内のグループ コントロールの下に存在する可能性があります。

関連するプロパティ

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

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

 

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

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

コントロール パターン サポート Notes
IExpandCollapseProvider 依存 情報の表示と非表示に使用できるグループ コントロールは 、ExpandCollapse コントロール パターンをサポートしている必要があります。

 

必須イベント

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

UI オートメーション イベント Notes
UIA_AutomationFocusChangedEventId
プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。
プロパティ変更イベントUIA_ExpandCollapseExpandCollapseStatePropertyId します。 コントロールが ExpandCollapse コントロール パターン コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_IsOffscreenPropertyId。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベントUIA_ToggleToggleStatePropertyIdします。 コントロールが トグル コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

概念

UI オートメーション コントロール型の概要

UI オートメーションの概要