Slider コントロール型

このトピックでは、Microsoft UI オートメーションによる Slider コントロール型のサポートについて説明します。

スライダーコントロールは、ユーザーが数値の範囲を設定したり、項目のセットから選択したりできるようにするボタンを持つ複合コントロールです。

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

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

一般的なツリー構造

次の表に、スライダーコントロールに関連する UI オートメーションツリーの一般的なコントロールとコンテンツビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーションツリーの詳細については、「 Ui オートメーションツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
  • スライダー
    • ボタン (2 個または 4 個)
    • Thumb (1)
    • List Item (0 以上)
  • スライダー
    • List Item (0 以上)

 

関連するプロパティ

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

UI Automation のプロパティ メモ
UIA _ AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーションツリーの未加工ビューのすべてのピア要素間で一意である必要があります。
UIA _ BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA _ ClickablePointPropertyId 「ノート」を参照してください。 スライダーコントロールの大部分の四角形が子コントロールによって占有されているため、ほとんどのスライダーコントロールは UIA _ E _ noclickablepoint エラーを返す必要があります。
UIA _ ControlTypePropertyId スライダー この値は、すべてのフレームワークで同じです。
UIA _ IsContentElementPropertyId true スライダーコントロールは、常に UI オートメーションツリーのコンテンツビューに含まれます。
UIA _ IsControlElementPropertyId true スライダーコントロールは、常に UI オートメーションツリーのコントロールビューに含まれます。
UIA _ IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 スライダーコントロールの子 (ボタンとつまみ) は、フォーカスを受け取ることはできません。 フォーカスは常にスライダーコントロール自体にとどまります。
UIA _ LabeledByPropertyId 「ノート」を参照してください。 コントロールに関連付けられた静的テキストラベルが存在する場合、このプロパティはそのコントロールへの参照を公開する必要があります。 テキストコントロールが別のコントロールのサブコンポーネントである場合、 ラベル はプロパティが設定されません。
UIA _ LocalizedControlTypePropertyId 「ノート」を参照してください。 Slider コントロール型に対応する、ローカライズされた文字列。 既定値は、en-us または英語 (米国) の "slider" です。
UIA _ NamePropertyId 「ノート」を参照してください。 スライダーコントロールの名前は、通常、静的なテキストラベルから生成されます。 静的なテキストラベルがない場合は、アプリケーション開発者によって Name のプロパティ値が割り当てられている必要があります。

 

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

次の表に、すべてのスライダーコントロールでサポートされなければならない UI オートメーションコントロールパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロール パターン/パターン プロパティ サポート/値 メモ
IRangeValueProvider 依存 コンテンツを数値の範囲内の値に設定できる場合、スライダーは Rangevalue コントロールパターンをサポートする必要があります。
ISelectionProvider 依存 コンテンツが個別のオプションセットの中の1つの値を表す場合、スライダーは Selection コントロールパターンをサポートする必要があります。 Selection コントロール パターンがサポートされている場合、対応する選択を、スライダーの 1 つまたは複数の子リスト項目として公開する必要があります。
IValueProvider 依存 コンテンツが個別のオプションセットの中の1つの値を表す場合、スライダーは value コントロールパターンをサポートする必要があります。

 

必須イベント

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

UI オートメーションイベント メモ
UIA _ AutomationFocusChangedEventId
UIA _BoundingRectanglePropertyId プロパティ変更イベント。
UIA _IsEnabledPropertyId プロパティ変更イベント。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA _IsOffscreenPropertyId プロパティ変更イベント。 コントロールが Isoffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA _RangeValueValuePropertyId プロパティ変更イベント。 コントロールが Rangevalue コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA _ Selection _ InvalidatedEventId コントロールが Selection コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA _ StructureChangedEventId
UIA _ValueValuePropertyId プロパティ変更イベント。 コントロールが Value コントロールパターンをサポートしている場合は、このイベントをサポートする必要があります。

 

概念的

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

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