ウィンドウ コントロールの種類

  • [アーティクル]

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

ウィンドウ コントロールの種類は、異なるコンテンツを持つスクロール可能な領域を対象とします。 フレームまたはドキュメント ウィンドウ内のオブジェクトを表すために使用されます。 ユーザーは、ウィンドウ コントロール間と現在のウィンドウの内容内を移動できます。 ウィンドウ コントロールは、ウィンドウやドキュメントよりも低く、個々のコントロールの上にグループ化するレベルを表します。 ユーザーは、状況に応じて、TAB、F6、または CTRL + TAB キーを押すことによって、ペイン間を移動します。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • ペイン
  • ペイン

 

ウィンドウ コントロールは常にコントロールビューとコンテンツ ビューに表示されます。 オブジェクトが視覚的なプレゼンテーションにのみ使用される場合は、コントロールビューまたはコンテンツビューのペインとしてレイアウトオブジェクトを公開しないでください。

関連するプロパティ

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

UI Automation のプロパティ 値 Notes
UIA_AccessKeyPropertyId 「ノート」を参照してください。 特定のキーの組み合わせによってウィンドウにフォーカスが与えられる場合は、このプロパティを使用してその情報を公開する必要があります。
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 このプロパティは、クリックされた場合にペインにフォーカスが移動する、ペイン コントロールのクリック可能なポイントを公開します。
UIA_ControlTypePropertyId ペイン
UIA_HelpTextPropertyId 「ノート」を参照してください。 ウィンドウ コントロールのヘルプ テキストでは、フレームの目的と他のフレームとの関係について説明する必要があります。 フレームの目的と関係が 、UIA_NamePropertyId プロパティの値から明確でない場合は、説明が必要です。
UIA_IsContentElementPropertyId true ペイン コントロールは、常にUI オートメーション ツリーのコンテンツ ビューに含まれます。
UIA_IsControlElementPropertyId true ペイン コントロールは常に、UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId 「ノート」を参照してください。 通常、ペイン コントロールに静的ラベルはありません。 静的なテキスト ラベルが存在する場合は、このプロパティを介して公開する必要があります。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 Pane コントロールの種類に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "pane" です。
UIA_NamePropertyId 「ノート」を参照してください。 このプロパティの値は、必ず明確で簡潔でわかりやすいタイトルにする必要があります。

 

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

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

コントロール パターン サポート Notes
IDockProvider 依存 ペイン コントロールを ドッキング できる場合は、Dock コントロール パターンを実装します。
IScrollProvider 依存 ウィンドウ コントロールを スクロール できる場合は、スクロール コントロール パターンを実装します。
ITransformProvider 依存 ウィンドウ コントロールを画面上で移動、サイズ変更、または回転できる場合は、 Transform コントロール パターンを実装します。
IWindowProvider 行わない 要素が Window コントロール パターンを実装する必要がある場合、コントロールは Window コントロール型に基づいている必要があります。

 

必須イベント

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

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

 

Pane コントロール型の例

次の図は、 Pane コントロールの種類を実装するコントロールを示しています。

ペイン コントロールの例を示すスクリーン ショット

UI オートメーション ツリー - コントロール ビュー UI オートメーション ツリー - コンテンツ ビュー
  • ペイン
    • ツリー (スクロール パターン)
      • TreeItem
      • ...
  • ペイン
    • 編集 (スクロール パターン)
  • ペイン
    • ツリー (スクロール パターン)
      • TreeItem
      • ...
    • ペイン
      • 編集 (スクロール パターン)

 

概念

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

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