次の方法で共有

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

  • [アーティクル]

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

ウィンドウ コントロールは、タイトル バー、クライアント、その他のオブジェクトなどの子オブジェクトを含むウィンドウ フレームで構成されます。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 窓
  • 窓

 

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 ウィンドウ コントロールにはクリック可能なポイントが必要です。これにより、ウィンドウが選択または選択解除されます。
UIA_ControlTypePropertyId ウィンドウの この値は、すべての UI フレームワークで同じです。
UIA_IsContentElementPropertyId 真 ウィンドウ コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。
UIA_IsControlElementPropertyId 真 ウィンドウ コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ヌル ウィンドウ コントロールには静的ウィンドウ ラベルがありません。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 Window コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の場合は "window" です。
UIA_NamePropertyId ノートを参照してください。 ウィンドウ コントロールには、アイテムの最もセマンティック識別子としてユーザーが関連付ける内容に関連するプライマリ ウィンドウ要素が常に含まれます。

 

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

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

Control Pattern/Pattern プロパティ サポート/値 筆記
IDockProviderの 条件付きの ウィンドウをドッキングできる場合は、Dock コントロール パターンをサポートする必要があります。
ITransformProviderの 必須 変換 コントロール パターンを使用すると、ウィンドウを画面上で移動、サイズ変更、または回転できます。 (Windows ストア アプリには適用されません)。
IWindowProviderの 必須 ウィンドウ コントロール パターンにより、ウィンドウに対する特定の操作が可能になります。

 

必要なイベント

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

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

 

概念

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

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