次の方法で共有

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

  • [アーティクル]

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

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

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • ウィンドウ
  • ウィンドウ

 

関連するプロパティ

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

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

 

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

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

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

 

必須イベント

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

UI オートメーション イベント Notes
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 オートメーションの概要