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

  • [アーティクル]

このトピックでは、スピナー コントロールの種類に対する 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 オートメーションの概要