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

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、Separator コントロール型の UI Automation サポートに関する情報を示します。 UI Automationでは、コントロール型とはコントロールが ControlTypeProperty プロパティを使用するために満たしている必要のある一連の条件を表します。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

区分線コントロールは、スペースを 2 つの領域に視覚的に分割するために使用します。 たとえば、区分線コントロールを使用して、ウィンドウ内の 2 つのペインを定義することができます。 区分線を移動できるようにするには、コントロールを Thumb コントロール型として公開する必要があります。

以下のセクションでは、Separator コントロール型の必須の UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントの定義を示します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Forms のいずれの場合でも、すべてのリスト コントロールに当てはまります。

このトピックは、次のセクションで構成されています。

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

次の表では、区分線コントロールに関連する UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー	コンテンツ ビュー
Separator	区分線コントロールは、コンテンツを持ちません。

必須の UI オートメーション プロパティ

次の表は、UI Automationのプロパティのうち、値または定義が特に区分線コントロールに重要であるものの一覧です。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI Automation プロパティ	値	メモ
AutomationIdProperty	メモを参照	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	メモを参照	コントロール全体を包含する外側の四角形。
ClickablePointProperty	メモを参照	外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。
IsKeyboardFocusableProperty	メモを参照	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	""	区分線コントロールでは、NameProperty は必要ありません。
LabeledByProperty	null	区分線コントロールには静的ラベルはありません。
ControlTypeProperty	Separator	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"区分線"	Separator コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	False	区分線コントロールはコンテンツではありません。
IsControlElementProperty	True	区分線コントロールは、常にコントロールである必要があります。

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

区分線コントロールは、コントロール パターンをサポートする必要はありません。「」を参照してください。

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

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

UI Automation イベント	サポート	説明
BoundingRectangleProperty プロパティ変更イベント	必須	なし
IsOffscreenProperty プロパティ変更イベント	必須	なし
IsEnabledProperty プロパティ変更イベント	必須	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

参照

Separator

概念

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

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