次の方法で共有

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

  • [アーティクル]

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

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

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

このトピックには、次のセクションが含まれています。

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 群
    • 0 または多数のコントロール
  • 群
    • 0 または多数のコントロール

 

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

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
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 オートメーション コントロール パターンの概要」を参照してください。

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

 

必要なイベント

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

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

 

概念

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

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