スピナー コントロールの種類

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

スピン ボタン コントロールは、ある範囲の項目や数字から選択するために使用します。

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

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

• 一般的なツリー構造
• 関連するプロパティ
• 必須のコントロール パターン
• 必須イベント
• 関連トピック

一般的なツリー構造

次の表は、RangeValue コントロールと Selection コントロール パターンをサポートする場合のスピナー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

RangeValue コントロール パターン

コントロール ビュー	コンテンツ ビュー
Spinner Edit (0 または 1) Button (2)	Spinner

 

Selection コントロール パターン

コントロール ビュー	コンテンツ ビュー
Spinner Edit (0 または 1) Button (2) List Item (0 以上)	Spinner ListItem (0 以上)

 

コントロール ビュー サブツリーの 2 つのボタンを自動テスト ツールで区別できるようにするには、必要に応じて 、ScrollAmount_SmallIncrement または ScrollAmount_SmallDecrement 値を AutomationId プロパティに割り当てます。 一部の実装では、関連付けられている編集コントロールがスピナー コントロールのピアである場合があります。

関連するプロパティ

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

UI Automation のプロパティ	値	Notes
UIA_AutomationIdPropertyId	「ノート」を参照してください。	このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId	「ノート」を参照してください。	コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId	「ノート」を参照してください。	スピン ボタン コントロールのクリック可能なポイントは、コントロールの編集部分にフォーカスを設定します。
UIA_ControlTypePropertyId	Spinner	この値は、すべてのフレームワークで同じです。
UIA_IsContentElementPropertyId	true	スピン ボタン コントロールは、常にコンテンツである必要があります。
UIA_IsControlElementPropertyId	true	スピナー コントロールは常にコントロールである必要があります。
UIA_IsKeyboardFocusablePropertyId	「ノート」を参照してください。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 スピナー コントロールがフォーカスを受け取ることはめったにありませんが、フォーカスがある場合は、子ボタンではなく、スピナー コントロール自体にフォーカスを残す必要があります。 ユーザーは、上方向キーと下方向キーを使用して、すべてのスクロール 操作を実行できる必要があります。
UIA_LabeledByPropertyId	「ノート」を参照してください。	スピン ボタン コントロールには静的なテキスト ラベルがあります。
UIA_LocalizedControlTypePropertyId	「ノート」を参照してください。	スピナー コントロールの種類に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "スピナー" です。
UIA_NamePropertyId	「ノート」を参照してください。	スピン ボタン コントロールは、通常、静的テキスト ラベルからその名前を取得します。

 

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

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

コントロール パターン/パターン プロパティ	サポート/値	Notes
IRangeValueProvider	依存	数値範囲にまたがるスピナー コントロールは、 RangeValue コントロール パターンをサポートできます。
ISelectionProvider	依存	選択する項目のリストを持つスピナー コントロールは 、Selection コントロール パターンをサポートしている必要があります。
CanSelectMultiple	FALSE	スピン ボタン コントロールは、常に単一選択コンテナーです。
IValueProvider	依存	オプションまたは数値の descrete セットにまたがるスピナー コントロールは、 値 コントロール パターンをサポートできます。

 

必須イベント

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

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

 

関連トピック

概念

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

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