UI オートメーションによる ProgressBar コントロール型のサポート
更新 : 2007 年 11 月
ここでは、UI オートメーションによる ProgressBar コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、コントロール パターン、および UI オートメーション イベントに関する特定のガイドラインが含まれます。
ProgressBar コントロール型を実装するコントロールとして、進行状況バー コントロールなどがあります。進行状況バー コントロールは、時間のかかる操作の進行状況を示すために使用します。このコントロールは、処理の進行状況に合わせてシステムの強調表示色で塗りつぶされていく四角形から構成されています。
以下のセクションでは、ProgressBar コントロール型の必須の UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォーム のいずれの場合でも、すべてのリスト コントロールに当てはまります。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、プログレス バー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
|
進行状況バー コントロールは、UI オートメーションツリーのコントロールまたはコンテンツ ビューに子を持つことはありません。
必須の UI オートメーション プロパティ
次の表に、値または定義が特にプログレス バー コントロールに関連する UI オートメーション プロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
説明 |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
通常、進行状況バー コントロールの名前は、静的テキスト ラベルから取得されます。静的テキスト ラベルが存在しない場合、アプリケーションの開発者は Name プロパティの値を公開する必要があります。 |
|
説明を参照。 |
静的テキスト ラベルが存在する場合、このプロパティは、該当するコントロールへの参照を公開する必要があります。 |
|
ProgressBar |
この値は、すべての UI フレームワークで共通です。 |
|
"進行状況バー" |
ProgressBar コントロール型に対応するローカライズされた文字列。 |
|
True |
進行状況バー コントロールは、常に UI オートメーションツリーのコンテンツ ビューに含まれます。 |
|
True |
進行状況バー コントロールは、常に UI オートメーションツリーのコントロール ビューに含まれます。 |
必須の UI オートメーション コントロール パターン
進行状況バー コントロールでサポートする必要がある UI オートメーションコントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
依存 |
進行状況をテキストで示す進行状況バー コントロールは、IValueProvider を実装する必要があります。 |
|
True |
このプロパティの値は常に True です。 |
|
説明を参照。 |
このプロパティは、進行状況バー コントロールのテキストによる進行状況を公開します。 |
|
依存 |
数値の範囲を取る進行状況バー コントロールは、IRangeValueProvider を実装する必要があります。 |
|
0.0 |
このプロパティの値は、コントロールに対して設定できる最小の値である必要があります。 |
|
100.0 |
このプロパティの値は、コントロールに対して設定できる最大の値である必要があります。 |
|
NaN |
進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。 |
|
NaN |
進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。 |
必須の UI オートメーション イベント
すべての進行状況バー コントロールでサポートする必要がある UI オートメーションイベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
説明 |
|---|---|---|
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
NameProperty プロパティ変更イベント。 |
必須 |
なし |
ValueProperty プロパティ変更イベント。 |
依存 |
なし |
ValueProperty プロパティ変更イベント。 |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |