次の方法で共有


UI オートメーションによる Pane コントロール型のサポート

メモメモ

このドキュメントは、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 プロパティ

説明

AutomationIdProperty

説明を参照。

このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。

BoundingRectangleProperty

説明を参照。

コントロール全体を包含する外側の四角形。

IsKeyboardFocusableProperty

説明を参照。

コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。

NameProperty

説明を参照。

このプロパティの値は、常に明瞭、簡潔で意味のあるタイトルである必要があります。

ClickablePointProperty

説明を参照。

このプロパティは、クリックされるとそのペインにフォーカスが設定される、ペイン コントロールのクリック可能なポイントを公開します。

LabeledByProperty

説明を参照。

通常、ペイン コントロールには、静的なラベルはありません。 静的なテキスト ラベルがある場合は、このプロパティを使用して公開します。

ControlTypeProperty

Pane

この値は、すべての UI フレームワークで共通です。

LocalizedControlTypeProperty

"ペイン"

Pane コントロール型に対応する、ローカライズされた文字列。

IsContentElementProperty

True

ペイン コントロールは、常に UI Automation ツリーのコンテンツ ビューに含まれます。

IsControlElementProperty

True

ペイン コントロールは、常に UI Automation ツリーのコントロール ビューに含まれます。

HelpTextProperty

""

ペイン コントロールのヘルプ テキストでは、そのフレームの目的および他のフレームとの関係を説明する必要があります。 フレームの目的や関係が NameProperty の値からはわかりにくい場合は、説明が必要です。 "

AccessKeyProperty

説明を参照。

特定のキーの組み合わせでペインにフォーカスが設定される場合は、その情報をこのプロパティで公開する必要があります。

必須の UI オートメーション コントロール パターン

すべてのペイン コントロールでサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

コントロール パターン

サポート

説明

ITransformProvider

依存

ペイン コントロールが画面上で移動、サイズ変更、回転できる場合に、このコントロール パターンを実装します。

IWindowProvider

なし

このコントロール パターンを実装する場合は、コントロールが Window コントロール型に基づいている必要があります。

IDockProvider

依存

ペイン コントロールがドッキング可能な場合に、このコントロール パターンを実装します。

IScrollProvider

依存

ペイン コントロールがスクロール可能な場合に、このコントロール パターンを実装します。

必須の UI オートメーション イベント

すべてのペイン コントロールでサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI Automation イベント

サポート/値

説明

WindowClosedEvent

なし

なし

WindowOpenedEvent

なし

なし

AsyncContentLoadedEvent

必須

なし

BoundingRectangleProperty プロパティ変更イベント

必須

なし

IsOffscreenProperty プロパティ変更イベント

必須

なし

IsEnabledProperty プロパティ変更イベント

必須

なし

HorizontallyScrollableProperty プロパティ変更イベント

依存

なし

HorizontalScrollPercentProperty プロパティ変更イベント

依存

なし

HorizontalViewSizeProperty プロパティ変更イベント

依存

なし

VerticalScrollPercentProperty プロパティ変更イベント

依存

なし

VerticallyScrollableProperty プロパティ変更イベント

依存

なし

VerticalViewSizeProperty プロパティ変更イベント

依存

なし

WindowVisualStateProperty プロパティ変更イベント

なし

なし

AutomationFocusChangedEvent

必須

なし

StructureChangedEvent

必須

なし

Pane コントロール型の例

次の図に、Pane コントロール型を実装するコントロールを示します。

2 つのペインを含むアプレット ウィンドウのスクリーンショット

UI Automation ツリー - コントロール ビュー

UI Automation ツリー - コンテンツ ビュー

  • Pane

  • Tree (Scroll パターン)

    • TreeItem

    • Pane

    • Edit (Scroll パターン)

  • Pane

  • Tree (Scroll パターン)

  • TreeItem

  • …Pane

  • Edit

  • (Scroll パターン)

参照

参照

Pane

概念

UI オートメーション コントロール型の概要

UI オートメーションの概要