UI オートメーションによる ScrollBar コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、ScrollBar コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
スクロール バー コントロールを使用すると、ユーザーは、ウィンドウまたは項目のコンテナー内のコンテンツをスクロールできます。 このコントロールは、ボタンのセットと Thumb コントロールから構成されます。
以降のセクションでは、ScrollBar コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのリスト コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、スクロール バー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| ScrollBar - Button (2 または 4) - Thumb (0 または 1) |
適用不可。 スクロール バー コントロールは、コンテンツを含みません。 |
スクロール バー コントロールは、常に 3 ～ 5 個の子を持っています。 サブツリーには複数のボタン コントロールが存在するため、各項目に特定の AutomationIdProperty 値を設定して、それらの項目が自動テスト ツールで検出されるようにする必要があります。
必須の UI オートメーション プロパティ
次の表に、スクロール バー コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 スクロール バー コントロールはコンテンツを持たないことに注意してください。このコントロールの機能は、スクロールされるコンテナーでサポートされる Scroll コントロール パターンによって公開されます。
UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | Null |
スクロール バー コントロールはコンテンツ要素を持たないため、 NameProperty を設定する必要はありません。 |
| ClickablePointProperty | 数値でない値。 | スクロール バー コントロールには、クリック可能なポイントはありません。 |
| LabeledByProperty | Null |
スクロール バーには、ラベルはありません。 |
| ControlTypeProperty | ScrollBar | この値は、すべてのフレームワークで同じです。 スライダーとして機能するスクロール バーには、Slider コントロール型を使用する必要があります。 |
| LocalizedControlTypeProperty | "スクロール バー" | Button コントロール型に対応するローカライズされた文字列。 |
| IsContentElementProperty | × | スクロール バー コントロールは、コンテンツ要素ではありません。 スクロール バーがスタンドアロンのコントロールである場合、そのスクロール バーは、Slider コントロール型の機能を満たし、 ControlType.Slider プロパティの ControlType を返す必要があります。 |
| IsControlElementProperty | ○ | スクロール バーは、常にコントロールである必要があります。 |
| OrientationProperty | ○ | スクロール バー コントロールは、水平方向または垂直方向の向きを常に公開する必要があります。 |
必須の UI オートメーション コントロール パターン
次の表に、スクロール バー コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。 スクロール バーをマウス操作専用のコントロールとして使用する場合、スクロール バーはコントロール パターンをサポートしないことに注意してください。 スクロール バーをアプリケーション内のスライダー コントロールとして使用する場合は、Slider コントロール型にする必要があります。
| コントロール パターン | サポート | Notes |
|---|---|---|
| IScrollProvider | 行わない | Scroll コントロール パターンは、スクロール バーで直接的にはサポートされていません。 |
| IRangeValueProvider | 依存 | この機能は、スクロール バーのあるコンテナーで Scroll コントロール パターンがサポートされない場合に限ってサポートする必要があります。 |
必須の UI オートメーション イベント
次の表に、すべてのスクロール バー コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート/値 | Notes |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| HorizontallyScrollableProperty プロパティ変更イベント。 | なし | なし |
| HorizontalScrollPercentProperty プロパティ変更イベント。 | なし | なし |
| HorizontalViewSizeProperty プロパティ変更イベント。 | なし | なし |
| VerticalScrollPercentProperty プロパティ変更イベント。 | なし | なし |
| VerticallyScrollableProperty プロパティ変更イベント。 | なし | なし |
| VerticalViewSizeProperty プロパティ変更イベント。 | なし | なし |
| ValueProperty プロパティ変更イベント。 | 依存 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |