UI オートメーションによる Pane コントロール型のサポート
.gif "メモ") メモ |
|---|
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。 |
ここでは、UI Automationによる Pane コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
Pane コントロール型の使用目的は、フレームまたはドキュメント ウィンドウ内のオブジェクトを表すことです。 ユーザーは、ペイン コントロール間や現在のペインのコンテンツ内を移動できますが、異なるペインの項目間は移動できません。 つまり、ペイン コントロールは、ウィンドウやドキュメントの下位にあり、個別のコントロールの上位にあるグループ化レベルを表します。 ユーザーがペイン間を移動するには、コンテキストに応じて Tab キー、F6 キー、または Ctrl + Tab キーを押します。 Pane コントロール型には、特定のキーボード ナビゲーションは必要ありません。
以下のセクションでは、Pane コントロール型の必須の UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントの定義を示します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Forms のいずれの場合でも、すべてのリスト コントロールに当てはまります。
このトピックは、次のセクションで構成されています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- Pane コントロール型の例
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、ペイン コントロールに関連した UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
Pane |
Pane |
必須の UI オートメーション プロパティ
次の表は、UI Automationのプロパティのうち、値または定義が特にペイン コントロールに重要であるものの一覧です。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI Automation プロパティ |
値 |
説明 |
|---|---|---|
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
|
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
このプロパティの値は、常に明瞭、簡潔で意味のあるタイトルである必要があります。 |
|
説明を参照。 |
このプロパティは、クリックされるとそのペインにフォーカスが設定される、ペイン コントロールのクリック可能なポイントを公開します。 |
|
説明を参照。 |
通常、ペイン コントロールには、静的なラベルはありません。 静的なテキスト ラベルがある場合は、このプロパティを使用して公開します。 |
|
Pane |
この値は、すべての UI フレームワークで共通です。 |
|
"ペイン" |
Pane コントロール型に対応する、ローカライズされた文字列。 |
|
True |
ペイン コントロールは、常に UI Automation ツリーのコンテンツ ビューに含まれます。 |
|
True |
ペイン コントロールは、常に UI Automation ツリーのコントロール ビューに含まれます。 |
|
"" |
ペイン コントロールのヘルプ テキストでは、そのフレームの目的および他のフレームとの関係を説明する必要があります。 フレームの目的や関係が NameProperty の値からはわかりにくい場合は、説明が必要です。 " |
|
説明を参照。 |
特定のキーの組み合わせでペインにフォーカスが設定される場合は、その情報をこのプロパティで公開する必要があります。 |
必須の UI オートメーション コントロール パターン
すべてのペイン コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン |
サポート |
説明 |
|---|---|---|
依存 |
ペイン コントロールが画面上で移動、サイズ変更、回転できる場合に、このコントロール パターンを実装します。 |
|
なし |
このコントロール パターンを実装する場合は、コントロールが Window コントロール型に基づいている必要があります。 |
|
依存 |
ペイン コントロールがドッキング可能な場合に、このコントロール パターンを実装します。 |
|
依存 |
ペイン コントロールがスクロール可能な場合に、このコントロール パターンを実装します。 |
必須の UI オートメーション イベント
すべてのペイン コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI Automation イベント |
サポート/値 |
説明 |
|---|---|---|
なし |
なし |
|
なし |
なし |
|
必須 |
なし |
|
BoundingRectangleProperty プロパティ変更イベント |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント |
必須 |
なし |
HorizontallyScrollableProperty プロパティ変更イベント |
依存 |
なし |
HorizontalScrollPercentProperty プロパティ変更イベント |
依存 |
なし |
HorizontalViewSizeProperty プロパティ変更イベント |
依存 |
なし |
VerticalScrollPercentProperty プロパティ変更イベント |
依存 |
なし |
VerticallyScrollableProperty プロパティ変更イベント |
依存 |
なし |
VerticalViewSizeProperty プロパティ変更イベント |
依存 |
なし |
WindowVisualStateProperty プロパティ変更イベント |
なし |
なし |
必須 |
なし |
|
必須 |
なし |
Pane コントロール型の例
次の図に、Pane コントロール型を実装するコントロールを示します。
.gif "2 つのペインを含むアプレット ウィンドウのスクリーンショット")
UI Automation ツリー - コントロール ビュー |
UI Automation ツリー - コンテンツ ビュー |
|---|---|
|
|