スライダー コントロールの種類

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

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

次のセクションでは、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 「ノート」を参照してください。 コントロールに関連付けられている静的テキスト ラベルがある場合、このプロパティはそのコントロールへの参照を公開する必要があります。 テキスト コントロールが別のコントロールのサブコンポーネントである場合、 LabeledBy プロパティは設定されません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 Slider コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "スライダー" です。
UIA_NamePropertyId 「ノート」を参照してください。 スライダー コントロールの名前は、通常、静的テキスト ラベルから生成されます。 静的テキスト ラベルがない場合は、アプリケーション開発者が Name のプロパティ値を割り当てる必要があります。

 

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

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

コントロール パターン/パターン プロパティ サポート/値 メモ
IRangeValueProvider 依存 コンテンツを数値範囲内の値に設定できる場合、スライダーは RangeValue コントロール パターンをサポートする必要があります。
ISelectionProvider 依存 コンテンツが個別のオプション セットの中で 1 つの値を表す場合、スライダーは 選択 コントロール パターンをサポートする必要があります。 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 オートメーションの概要