UI オートメーションによる Spinner コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、Spinner コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
スピン ボタン コントロールは、ある範囲の項目や数字から選択するために使用します。
以降のセクションでは、Spinner コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのスピン ボタン コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、Range Value、Value、および Selection の各コントロール パターンをサポートするスピン ボタン コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
Range Value コントロール パターンまたは Value コントロール パターン
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| Spinner - Edit (0 または 1) - Button (2) |
Spinner |
Selection コントロール パターン
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| Spinner - Edit (0 または 1) - Button (2) - List Item (0 以上) |
Spinner - ListItem (0 以上) |
コントロール ビュー サブツリーの 2 つのボタンを自動テスト ツールが区別できるようにするには、必要に応じて SmallIncrement または SmallDecrement AutomationId を割り当てます。 実装によっては、関連付けられたエディット コントロールが Spinner コントロールのピアである場合があります。
必須の UI オートメーション プロパティ
次の表に、スピン ボタン コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | スピン ボタン コントロールのクリック可能なポイントは、コントロールの編集部分にフォーカスを設定します。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | スピン ボタン コントロールは、通常、静的テキスト ラベルからその名前を取得します。 |
| LabeledByProperty | 「ノート」を参照してください。 | スピン ボタン コントロールには静的なテキスト ラベルがあります。 |
| ControlTypeProperty | Spinner | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "スピン ボタン" | Spinner コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | ○ | スピン ボタン コントロールは、常にコンテンツである必要があります。 |
| IsControlElementProperty | ○ | Spinner コントロールは、常にコントロールである必要があります。 |
必須の UI オートメーション コントロール パターンおよびプロパティ
次の表に、スピン ボタン コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンについて詳しくは、「 UI Automation Control Patterns Overview」をご覧ください。
| コントロール パターン/パターン プロパティ | サポート/値 | Notes |
|---|---|---|
| ISelectionProvider | 依存 | 選択する項目のリストを持つスピン ボタン コントロールは、このパターンをサポートする必要があります。 |
| CanSelectMultiple | × | スピン ボタン コントロールは、常に単一選択コンテナーです。 |
| IRangeValueProvider | 依存 | 数値の範囲を対象にするスピン ボタン コントロールは、このパターンをサポートできます。 |
| IValueProvider | 依存 | 個別のオプション セットまたは数値のセットを対象にするスピン ボタン コントロールは、このパターンをサポートできます。 |
必須の UI オートメーション イベント
次の表に、すべてのスピン ボタン コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| InvalidatedEvent | 依存 | なし |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| ValueProperty プロパティ変更イベント。 | 依存 | なし |
| ValueProperty プロパティ変更イベント。 | 依存 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |