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