次の方法で共有

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

  • [アーティクル]

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

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

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

このトピックには、次のセクションが含まれています。

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • 分離器
  • コントロールの種類 区切り記号にはコンテンツがありません。

 

関連するプロパティ

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

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

 

必要なコントロール パターン

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

必要なイベント

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

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

 

概念

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

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