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