注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、ペイン コントロールの種類に対する UI オートメーションのサポートについて説明します。 UI オートメーションでは、コントロール型は、 ControlTypeProperty プロパティを使用するためにコントロールが満たす必要がある一連の条件です。 条件には、UI オートメーション ツリー構造、UI オートメーション プロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
ペイン コントロールの種類は、フレームまたはドキュメントウィンドウ内のオブジェクトを表します。 ユーザーは、ペイン コントロール間と現在のペインの内容内を移動できますが、異なるペイン内の項目間を移動することはできません。 したがって、ウィンドウ コントロールは、ウィンドウまたはドキュメントよりも低いグループ化のレベルを表しますが、個々のコントロールより上です。 ユーザーは、コンテキストに応じて Tab キー、F6 キー、または Ctrl キーを押しながら Tab キーを押してペイン間を移動します。 ウィンドウ コントロールの種類では、特定のキーボード ナビゲーションは必要ありません。
次のセクションでは、Pane コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれであっても、すべてのリスト コントロールに適用されます。
必要な UI オートメーション ツリー構造
次の表は、ペイン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「 UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| ペイン | ペイン |
必要な UI オートメーション プロパティ
次の表に、ウィンドウ コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「 クライアントの UI オートメーション プロパティ」を参照してください。
| UI オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | ノートを参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| IsKeyboardFocusableProperty | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | ノートを参照してください。 | このプロパティの値は、常に明確で簡潔でわかりやすいタイトルである必要があります。 |
| ClickablePointProperty | ノートを参照してください。 | このプロパティは、ウィンドウ コントロールのクリック可能なポイントを公開します。これにより、ウィンドウがクリックされたときにウィンドウにフォーカスが移動します。 |
| LabeledByProperty | ノートを参照してください。 | 通常、ペイン コントロールには静的ラベルがありません。 静的なテキスト ラベルがある場合は、このプロパティを使用して公開する必要があります。 |
| ControlTypeProperty | ペイン | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "pane" | Pane コントロールの種類に対応するローカライズされた文字列。 |
| IsContentElementProperty | 正しい | ペイン コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。 |
| IsControlElementProperty | 正しい | ペイン コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
| HelpTextProperty | "" | ウィンドウ コントロールのヘルプ テキストでは、フレームの目的とその他のフレームとの関係を説明する必要があります。 フレームの目的と関係が NamePropertyの値から明確でない場合は、説明が必要です。 「」 |
| AccessKeyProperty | ノートを参照してください。 | 特定のキーの組み合わせによってウィンドウにフォーカスが与えられる場合は、このプロパティを使用してその情報を公開する必要があります。 |
必要な UI オートメーション コントロール パターン
次の表に、すべてのペイン コントロールでサポートされる必要がある UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支援 | 注記 |
|---|---|---|
| ITransformProvider | 依存 | ウィンドウ コントロールを画面上で移動、サイズ変更、または回転できる場合は、このコントロール パターンを実装します。 |
| IWindowProvider | 決してない | このコントロール パターンを実装する必要がある場合は、コントロールが Window コントロールの種類に基づいている必要があります。 |
| IDockProvider | 依存 | ペイン コントロールをドッキングできる場合は、このコントロール パターンを実装します。 |
| IScrollProvider | 依存 | ウィンドウ コントロールをスクロールできる場合は、このコントロール パターンを実装します。 |
必要な UI オートメーション イベント
次の表に、すべてのペイン コントロールでサポートされる必要がある UI オートメーション イベントの一覧を示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | サポート/値 | 注記 |
|---|---|---|
| WindowClosedEvent | 決してない | 無し |
| WindowOpenedEvent | 決してない | 無し |
| AsyncContentLoadedEvent | 必須 | 無し |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| HorizontallyScrollableProperty プロパティ変更イベント。 | 依存 | 無し |
| HorizontalScrollPercentProperty プロパティ変更イベント。 | 依存 | 無し |
| HorizontalViewSizeProperty プロパティ変更イベント。 | 依存 | 無し |
| VerticalScrollPercentProperty プロパティ変更イベント。 | 依存 | 無し |
| VerticallyScrollableProperty プロパティ変更イベント。 | 依存 | 無し |
| VerticalViewSizeProperty プロパティ変更イベント。 | 依存 | 無し |
| WindowVisualStateProperty プロパティ変更イベント。 | 決してない | 無し |
| AutomationFocusChangedEvent | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |
ペイン コントロールの種類の例
次の図は、Pane コントロール型を実装するコントロールを示しています。
| UI オートメーション ツリー - コントロール ビュー | UI オートメーション ツリー - コンテンツ ビュー |
|---|---|
|
-硝子 - ツリー (スクロール パターン) - TreeItem - …硝子 -編集 - (スクロール パターン) |