次の方法で共有

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

  • [アーティクル]

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

ウィンドウ コントロールの種類は、異なるコンテンツを含むスクロール可能な領域用です。 フレームまたはドキュメント ウィンドウ内のオブジェクトを表すために使用されます。 ユーザーは、ウィンドウ コントロール間と現在のウィンドウの内容内を移動できます。 ウィンドウ コントロールは、ウィンドウまたはドキュメントよりも低いグループ化のレベルを表しますが、個々のコントロールの上にあります。 ユーザーは、コンテキストに応じて Tab キー、F6 キー、または Ctrl キーを押しながら Tab キーを押してペイン間を移動します。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 硝子
  • 硝子

 

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

関連するプロパティ

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

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

 

必要なコントロール パターン

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

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

 

必要なイベント

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

UI オートメーション イベント 筆記
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 コントロール型を実装するコントロールを示しています。

ウィンドウ コントロールスクリーン ショット

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

 

概念

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

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