スピナー コントロールの種類
このトピックでは、Spinner コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。
スピナー コントロールは、項目のドメインまたは数値の範囲から選択するために使用されます。
次のセクションでは、Spinner コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのスピナー コントロールに適用されます。
このトピックには、次のセクションが含まれています。
- 一般的なツリー構造の
- 関連するプロパティ を する
- 必要なコントロール パターンの
- 必要なイベント を する
- 関連トピック
一般的なツリー構造
次の表は、RangeValue および Selection コントロール パターンをサポートする場合の、スピナー コントロールに関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
RangeValue コントロール パターンの
コントロール ビュー | コンテンツ ビュー |
---|---|
|
|
選択コントロール パターンの
コントロール ビュー | コンテンツ ビュー |
---|---|
|
|
コントロール ビュー サブツリー内の 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 コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
関連トピック