次の方法で共有


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

Note

このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。

このトピックでは、ProgressBar コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーション プロパティの値、コントロール パターン、UI オートメーション イベントに関する具体的なガイドラインが含まれます。

ProgressBar コントロール型を実装するコントロールの例として、進行状況バー コントロールなどがあります。 進行状況バー コントロールは、時間のかかる処理の進行状況を示すために使用します。 このコントロールは、処理の進行状況に合わせてシステムの強調表示色で塗りつぶされていく四角形で構成されます。

以降のセクションでは、ProgressBar コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのリスト コントロールに適用されます。

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

次の表に、進行状況バー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー コンテンツ ビュー
ProgressBar ProgressBar

進行状況バー コントロールには、UI オートメーション ツリーのコントロール ビューまたはコンテンツ ビュー内に子はありません。

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

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

UI Automation のプロパティ Notes
AutomationIdProperty 「ノート」を参照してください。 このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。
BoundingRectangleProperty 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
ClickablePointProperty 「ノート」を参照してください。 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。
IsKeyboardFocusableProperty 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty 「ノート」を参照してください。 進行状況バー コントロールの名前は、通常、静的なテキスト ラベルから取得されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が Name のプロパティ値を公開する必要があります。
LabeledByProperty 「ノート」を参照してください。 静的なテキスト ラベルがある場合、このプロパティは対象のコントロールへの参照を公開する必要があります。
ControlTypeProperty ProgressBar この値は、すべての UI フレームワークで同じです。
LocalizedControlTypeProperty "進行状況バー" ProgressBar コントロール型に対応する、ローカライズされた文字列。
IsContentElementProperty 進行状況バー コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。
IsControlElementProperty True 進行状況バー コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。

必須の UI オートメーション コントロール パターンおよびプロパティ

次の表に、進行状況バー コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロール パターン/パターン プロパティ サポート/値 Notes
IValueProvider 依存 進行状況をテキストで示す進行状況バー コントロールは、 IValueProviderを実装する必要があります。
IsReadOnly このプロパティの値は常に True です。
Value 「ノート」を参照してください。 このプロパティは、進行状況バー コントロールのテキストによる進行状況を公開します。
IRangeValueProvider 依存 数値の範囲を取る進行状況バー コントロールは、 IRangeValueProviderを実装する必要があります。
Minimum 0.0 このプロパティの値は、コントロールに対して設定できる最小の値です。
Maximum 100.0 このプロパティの値は、コントロールに対して設定できる最大の値です。
SmallChange NaN 進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。
LargeChange NaN 進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。

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

次の表に、すべての進行状況バー コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。

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

関連項目