ProgressBar コントロールの種類
このトピックでは、ProgressBar コントロール型の Microsoft UI オートメーション サポートについて説明します。
進行状況バー コントロールは、長い操作の進行状況を示します。 このコントロールは、処理の進行状況に合わせてシステムの強調表示色で塗りつぶされていく四角形で構成されます。
次のセクションでは、ProgressBar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーション要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべての進行状況バー コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、進行状況バー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
進行状況バー コントロールには、UI オートメーション ツリーのコントロール ビューまたはコンテンツ ビュー内に子はありません。
関連するプロパティ
次の表に、値または定義が進行状況バーに特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。 |
| UIA_ControlTypePropertyId | ProgressBar | |
| UIA_IsContentElementPropertyId | TRUE | 進行状況バー コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。 |
| UIA_IsControlElementPropertyId | TRUE | 進行状況バー コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_LabeledByPropertyId | 「ノート」を参照してください。 | 静的テキスト ラベルがある場合、このプロパティは、そのコントロールへの参照を公開する必要があります。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 | ProgressBar コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "進行状況バー" です。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | 進行状況バー コントロールの名前は、通常、静的なテキスト ラベルから取得されます。 静的なテキスト ラベルがない場合は、アプリケーション開発者が Name プロパティの値を公開する必要があります。 |
必須のコントロール パターン
次の表に、進行状況バー コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン/パターン プロパティ | サポート/値 | Notes |
|---|---|---|
| IRangeValueProvider | 依存 | 数値範囲を取得する進行状況バー コントロールは、 RangeValue コントロール パターンを実装する必要があります。 |
| 最小値 | 依存 | このプロパティの値は、コントロールを設定できる最小値です。 この値は Maximum より小さくする必要があります。 |
| 最大値 | 依存 | このプロパティの値は、コントロールを設定できる最大値です。 この値は Minimum より大きくする必要があります。 |
| Smallchange | NaN | 進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。 |
| Largechange | NaN | 進行状況バー コントロールは読み取り専用のため、このプロパティは不要です。 |
| IValueProvider | 依存 | 進行状況をテキストで示す進行状況バー コントロールは 、Value コントロール パターンを実装する必要があります。 |
| Isreadonly | TRUE | このプロパティの値は常に TRUE です。 |
| Value | 「ノート」を参照してください。 | このプロパティは、進行状況バー コントロールのテキストによる進行状況を公開します。 |
必須イベント
次の表は、進行状況バーがサポートするために必要なUI オートメーション イベントの一覧です。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | Notes |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。 | |
| プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_NamePropertyId 変更されたイベントです。 | |
| UIA_StructureChangedEventId | |
| プロパティUIA_RangeValueValuePropertyId 変更されたイベントです。 | コントロールが RangeValue コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_ValueValuePropertyId 変更されたイベントです。 | コントロールが Value コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
関連トピック