注
このドキュメントは、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 オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| 進捗バー | 進捗バー |
進行状況バー コントロールには、UI オートメーション ツリーのコントロールまたはコンテンツ ビューに子がありません。
必要な UI オートメーション プロパティ
次の表に、進行状況バー コントロールに特に関連する値または定義を持つ UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「 クライアントの UI オートメーション プロパティ」を参照してください。
| UI オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | ノートを参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | ノートを参照してください。 | コントロール全体を含む最も外側の四角形。 |
| ClickablePointProperty | ノートを参照してください。 | 外接する四角形がある場合にサポートされます。 外接する四角形内のポイントのすべてがクリック可能でない場合、かつ特殊なヒットテストを行うのであれば、オーバーライドしてクリック可能なポイントを指定してください。 |
| IsKeyboardFocusableProperty | ノートを参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | ノートを参照してください。 | 進行状況バー コントロールは、通常、静的テキスト ラベルからその名前を取得します。 静的なテキスト ラベルがない場合、アプリケーション開発者は Name プロパティの値を公開する必要があります。 |
| LabeledByProperty | ノートを参照してください。 | 静的なテキスト ラベルがある場合、このプロパティはそのコントロールへの参照を公開する必要があります。 |
| ControlTypeProperty | 進捗バー | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "進行状況バー" | ProgressBar コントロール型に対応するローカライズされた文字列。 |
| IsContentElementProperty | 正しい | 進行状況バー コントロールは、常に UI オートメーション ツリーのコンテンツ ビューに含まれます。 |
| IsControlElementProperty | 正しい | 進行状況バー コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。 |
必要な UI オートメーション コントロールのパターンとプロパティ
次の表に、進行状況バー コントロールでサポートするために必要な UI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
| Control Pattern/Pattern プロパティ | サポート/値 | 注記 |
|---|---|---|
| IValueProvider | 依存 | 進行状況をテキストで示す進行状況バー コントロールは、 IValueProviderを実装する必要があります。 |
| IsReadOnly | 正しい | このプロパティの値は常に True です。 |
| Value | ノートを参照してください。 | このプロパティは、進行状況バー コントロールのテキストの進行状況を公開します。 |
| IRangeValueProvider | 依存 | 数値範囲を受け取るプログレス バー コントロールを実装する必要がある IRangeValueProvider |
| Minimum | 0.0 | このプロパティの値は、コントロールを設定できる最小の値です。 |
| Maximum | 100.0 | このプロパティの値は、コントロールを設定できる最大値です。 |
| SmallChange | NaN | 進行状況バー コントロールは読み取り専用であるため、このプロパティは必要ありません。 |
| LargeChange | NaN | 進行状況バー コントロールは読み取り専用であるため、このプロパティは必要ありません。 |
必要な UI オートメーション イベント
次の表に、すべての進行状況バー コントロールでサポートされる必要がある UI オートメーション イベントの一覧を示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 支援 | 注記 |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| NameProperty プロパティ変更イベント。 | 必須 | 無し |
| ValueProperty プロパティ変更イベント。 | 依存 | 無し |
| AutomationFocusChangedEvent | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |