次の方法で共有


UI オートメーションによる Tree コントロール型のサポート

メモメモ

このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、UI Automationによる Tree コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

Tree コントロール型は、ファイルやフォルダーが Microsoft Windows Explorerの左ペインに表示される場合のように、コンテンツがノードの階層として関連性を持っているコンテナーに使用されます。 各ノードには、子ノードと呼ばれる他のノードを含めることができます。 親ノード (子ノードを含むノード) は、展開した状態または折りたたんだ状態で表示できます。

以下のセクションでは、Tree コントロール型で必要な UI Automationツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Formsのいずれの場合でも、すべてのツリー コントロールに当てはまります。

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

  • 必須の UI オートメーション ツリー構造
  • 必須の UI オートメーション プロパティ
  • 必須の UI オートメーション コントロール パターン
  • 必須の UI オートメーション イベント
  • 関連トピック

必須の UI オートメーション ツリー構造

次の表では、ツリー コントロールに関連した UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー

コンテンツ ビュー

Tree

  • DataItem (0 以上)

  • TreeItem (0 以上)

    • TreeItem (0 以上)• …

  • ScrollBar (0、1、2)

Tree

  • DataItem (0 以上)

  • TreeItem (0 以上)

    • TreeItem (0 以上)• …

UI Automationツリーのコントロール ビューは、次のものから構成されます。

  • コンテナー内の 0 個以上の項目 (項目は、Tree Item コントロール型、Data Item コントロール型、またはその他のコントロール型に基づいて設定できます)。

  • 0、1、または 2 個のスクロール バー。

UI Automation ツリーのコンテンツ ビューは、コンテナー内の 0 個以上の項目から構成されます (項目は、Tree Item コントロール型、Data Item コントロール型、またはその他のコントロール型に基づいて設定できます)。

必須の UI オートメーション プロパティ

値または定義がリスト コントロールに特に関連する UI Automationのプロパティの一覧を次の表に示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI Automation プロパティ

説明

AutomationIdProperty

説明を参照。

このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。

BoundingRectangleProperty

説明を参照。

コントロール全体を包含する外側の四角形。

ClickablePointProperty

説明を参照。

ツリー コントロールにはクリック可能なポイントがあり、これをクリックすると、ツリーまたはツリー コンテナー内の 1 つの項目にフォーカスが設定されます。 ツリー上にクリック可能なポイントが存在するのは、クリックしても 1 つの項目が選択されたり項目にフォーカスが設定されたりしない場所がある場合に限られます。

ControlTypeProperty

Tree

この値は、すべての UI フレームワークで共通です。

IsContentElementProperty

True

ツリー コントロールは、常に UI Automationツリーのコンテンツ ビューに含まれます。

IsControlElementProperty

True

ツリー コントロールは、UI Automationツリーのコントロール ビューに常に含まれます。

IsKeyboardFocusableProperty

説明を参照。

コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。

LabeledByProperty

説明を参照。

ツリー コントロールにラベルが関連付けられている場合、このプロパティはそのラベルの AutomationElement を返します。 それ以外の場合、このプロパティは null 参照 (Microsoft Visual Basic .NET の Nothing) を返します。

LocalizedControlTypeProperty

"ツリー"

List コントロール型に対応する、ローカライズされた文字列。

NameProperty

説明を参照。

ツリー コントロールの名前プロパティの値は、通常、コントロールにラベルを付けるテキストから取得されます。 テキスト ラベルが存在しない場合は、アプリケーションの開発者がこのプロパティの値を提供する必要があります。

必須の UI オートメーション コントロール パターン

リスト コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

コントロール パターン/パターン プロパティ

サポート/値

説明

ISelectionProvider

依存

選択可能な一連の項目を含むツリー コントロールは、このコントロール パターンを実装する必要があります。 このコントロール パターンは、項目を選択してもユーザーに有用な情報が伝達されない場合には、実装する必要はありません。

CanSelectMultiple

説明を参照。

ツリー コントロールが複数選択をサポートする場合、このプロパティを実装します (ほとんどのツリー コントロールは、複数選択をサポートしません)。

IsSelectionRequired

説明を参照。

このプロパティの値は、コントロールで項目が選択される必要がある場合に公開されます。

IScrollProvider

依存

ツリー コンテナーのコンテンツがスクロールできる場合は、このコントロール パターンを実装します。

必須の UI オートメーション イベント

すべてのツリー コントロールでサポートする必要がある UI Automationイベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI Automation イベント

サポート

説明

InvalidatedEvent

依存

なし

BoundingRectangleProperty プロパティ変更イベント

必須

なし

IsOffscreenProperty プロパティ変更イベント

必須

なし

IsEnabledProperty プロパティ変更イベント

必須

なし

HorizontallyScrollableProperty プロパティ変更イベント

依存

なし

HorizontalScrollPercentProperty プロパティ変更イベント

依存

なし

HorizontalViewSizeProperty プロパティ変更イベント

依存

なし

VerticalScrollPercentProperty プロパティ変更イベント

依存

なし

VerticallyScrollableProperty プロパティ変更イベント

依存

なし

VerticalViewSizeProperty プロパティ変更イベント

依存

なし

AutomationFocusChangedEvent

必須

なし

StructureChangedEvent

必須

なし

参照

参照

Tree

概念

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

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