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