区切り記号コントロールの種類

  • [アーティクル]

このトピックでは、区切り記号コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。

区切り記号コントロールは、視覚的にスペースを 2 つの領域に分割するために使用します。 たとえば、区切り記号コントロールは、ウィンドウ内の 2 つのペインを定義するバーにすることができます。 区切り記号が移動可能な場合は、コントロールをコントロールの種類のサムネイルとして公開する必要があります。

次のセクションでは、Separator コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべての区切り記号コントロールに適用されます。

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

一般的なツリー構造

次の表は、区切り記号コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • 区切り記号
  • Separator コントロールの種類にコンテンツが含まれることはありません。

 

関連するプロパティ

次の表に、区切り記号コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。

UI Automation のプロパティ 値 Notes
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId Separator
UIA_IsContentElementPropertyId FALSE 区切り記号コントロールはコンテンツではありません。
UIA_IsControlElementPropertyId true 区切り記号コントロールは常にコントロールにする必要があります。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId NULL 区切り記号コントロールには静的ラベルがありません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 Separator コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "Separator" です。
UIA_NamePropertyId "" 区切り記号コントロールには Name プロパティは必要ありません。

 

必須のコントロール パターン

コントロール パターンをサポートするために、区切り記号コントロールは必要ありません。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

必須イベント

次の表は、区切り記号コントロールがサポートするために必要なUI オートメーション イベントの一覧です。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。

UI オートメーション イベント Notes
UIA_AutomationFocusChangedEventId
プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。
プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

概念

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

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