UI オートメーションによる Window コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、Window コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
ウィンドウ コントロールは、子オブジェクト (タイトル バー、クライアント、その他のオブジェクトなど) が含まれているウィンドウ フレームで構成されます。
以下のセクションの UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、Window コントロール型を実装するすべてのコントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、ウィンドウ コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| ウィンドウ | ウィンドウ |
必須の UI オートメーション プロパティ
次の表に、ウィンドウ コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | ウィンドウ コントロールにはクリック可能なポイントがなければならず、これをクリックすることによってウィンドウが選択、または選択解除された状態になります。 |
| ControlTypeProperty | ウィンドウ | この値は、すべての UI フレームワークで同じです。 |
| IsContentElementProperty | ○ | ウィンドウ コントロールは、常にコンテンツである必要があります。 |
| IsControlElementProperty | ○ | ウィンドウ コントロールは、常にコントロールである必要があります。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| LabeledByProperty | null |
ウィンドウ コントロールには、静的な Window ラベルがありません。 |
| LocalizedControlTypeProperty | "window" | Window コントロール型に対応する、ローカライズされた文字列。 |
| NameProperty | 「ノート」を参照してください。 | ウィンドウ コントロールには、主要なウィンドウ要素が常に含まれています。この要素は、ユーザーがその項目の最もセマンティックな識別子として関連付けるであろうものに関連しています。 |
必須の UI オートメーション コントロール パターン
次の表に、ウィンドウ コントロールでサポートされる必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| IDockProvider | 条件付き | ウィンドウがドッキングできる場合は、サポートする必要があります。 |
| ITransformProvider | 必須 | ウィンドウが画面上で移動、サイズ変更、または回転できるようにします。 |
| IWindowProvider | 必須 | ウィンドウで特定の操作ができるようにします。 |
必須の UI オートメーション イベント
次の表に、すべてのウィンドウ コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| AsyncContentLoadedEvent | 必須 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| LayoutInvalidatedEvent | 必須 | なし |
| NameProperty プロパティ変更イベント。 | 必須 | なし |
| StructureChangedEvent | 必須 | なし |
| HorizontallyScrollableProperty プロパティ変更イベント。 | 依存 | なし |
| HorizontalScrollPercentProperty プロパティ変更イベント。 | 依存 | なし |
| HorizontalViewSizeProperty プロパティ変更イベント。 | 依存 | なし |
| VerticalScrollPercentProperty プロパティ変更イベント。 | 依存 | なし |
| VerticallyScrollableProperty プロパティ変更イベント。 | 依存 | なし |
| VerticalViewSizeProperty プロパティ変更イベント。 | 依存 | なし |
| WindowClosedEvent | 必須 | なし |
| WindowOpenedEvent | 必須 | なし |
| WindowVisualStateProperty プロパティ変更イベント。 | 依存 | なし |