次の方法で共有

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

  • [アーティクル]

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

スピナー コントロールは、項目のドメインまたは数値の範囲から選択するために使用されます。

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

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

一般的なツリー構造

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

RangeValue コントロール パターンの

コントロール ビュー コンテンツ ビュー
  • 紡績工
    • 編集 (0 または 1)
    • ボタン (2)
  • 紡績工

 

選択コントロール パターンの

コントロール ビュー コンテンツ ビュー
  • 紡績工
    • 編集 (0 または 1)
    • ボタン (2)
    • リスト アイテム (0 以上)
  • 紡績工
    • ListItem (0 以上)

 

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

関連するプロパティ

次の表に、値または定義がスピナー コントロールに特に関連する 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 または英語 (米国) の場合は "スピナー" です。
UIA_NamePropertyId ノートを参照してください。 通常、スピナー コントロールは静的なテキスト ラベルから名前を取得します。

 

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

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

Control Pattern/Pattern プロパティ サポート/値 筆記
IRangeValueProviderの 依存 数値範囲にまたがるスピナー コントロールは、RangeValue コントロール パターンをサポートできます。
ISelectionProviderの 依存 選択する項目の一覧を持つスピナー コントロールは、選択 コントロール パターンをサポートする必要があります。
CanSelectMultiple 偽 スピナー コントロールは常に 1 つの選択コンテナーです。
IValueProviderの 依存 一連のオプションまたは数値にまたがるスピナー コントロールは、値 コントロール パターンをサポートできます。

 

必要なイベント

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

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 オートメーションの概要