UI オートメーションによる Spinner コントロール型のサポート

更新 : 2007 年 11 月

ここでは、UI オートメーションによる Spinner コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

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

以下のセクションでは、Spinner コントロール型で必要な UI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのスピン コントロールに当てはまります。

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

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

次の表に、範囲値および Selection のコントロール パターンをサポートするスピン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

範囲値コントロール パターン

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

Selection コントロール パターン

コントロール ビュー	コンテンツ ビュー
Spinner Edit (0 または 1) Button (2) リスト項目 (2 つ以上)	Spinner ListItem (2 以上)

コントロール ビュー サブツリーの 2 つのボタンを自動テスト ツールが確実に区別できるようにするために、SmallIncrement または SmallDecrement の AutomationId を適切に割り当てます。

必須の UI オートメーション プロパティ

次の表に、値または定義が特にスピン コントロールに関連する UI オートメーションプロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI オートメーション プロパティ	値	説明
AutomationIdProperty()	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	説明を参照。	コントロール全体を包含する外側の四角形。
ClickablePointProperty	説明を参照。	スピン コントロールのクリック可能なポイントは、コントロールの編集部分にフォーカスを設定します。
IsKeyboardFocusableProperty	説明を参照。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	説明を参照。	通常、スピン コントロールの名前は、静的テキスト ラベルから取得されます。
LabeledByProperty	説明を参照。	スピン コントロールには、静的なテキスト ラベルがあります。
ControlTypeProperty	Spinner	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"spinner"	Spinner コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	True	スピン コントロールは、常にコンテンツである必要があります。
IsControlElementProperty	True	スピン コントロールは、常にコントロールである必要があります。

必須の UI オートメーション コントロール パターン

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

コントロール パターン/パターン プロパティ	サポート/値	説明
ISelectionProvider	依存	選択する項目のリストを持つスピン コントロールは、このパターンをサポートする必要があります。
CanSelectMultiple	False	スピン コントロールは、常に、単一選択コンテナです。
IRangeValueProvider	依存	数値の範囲を対象にするスピン コントロールは、このパターンをサポートする必要があります。

必須の UI オートメーション イベント

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

UI オートメーション イベント	サポート	説明
InvalidatedEvent	依存	なし
BoundingRectangleProperty プロパティ変更イベント。	必須	なし
IsOffscreenProperty プロパティ変更イベント。	必須	なし
IsEnabledProperty プロパティ変更イベント。	必須	なし
ValueProperty プロパティ変更イベント。	依存	なし
ValueProperty プロパティ変更イベント。	依存	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

概念

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

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

参照

Spinner