次の方法で共有


ProgressBar コントロールの種類

このトピックでは、ProgressBar コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。

進行状況バー コントロールは、時間の長い操作の進行状況を示します。 コントロールは、操作の進行に合わせて、システムの強調表示色で徐々に塗りつぶされる四角形で構成されます。

次のセクションでは、ProgressBar コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべての進行状況バー コントロールに適用されます。

このトピックには、次のセクションが含まれています。

一般的なツリー構造

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

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

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

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
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 オートメーション コントロール パターンの概要」を参照してください。

Control Pattern/Pattern プロパティ サポート/値 筆記
IRangeValueProvider 依存 数値範囲を取得する進行状況バー コントロールは、RangeValue コントロール パターンを実装する必要があります。
最小 依存 このプロパティの値は、コントロールを設定できる最小値です。 この値は、最大未満にする必要があります。
最大 依存 このプロパティの値は、コントロールを設定できる最大値です。 この値は、最小より大きくする必要があります。
SmallChange NaN する 進行状況バー コントロールは読み取り専用であるため、このプロパティは必要ありません。
LargeChange NaN する 進行状況バー コントロールは読み取り専用であるため、このプロパティは必要ありません。
IValueProvider 依存 進行状況をテキストで示す進行状況バー コントロールは、Value コントロール パターンを実装する必要があります。
IsReadOnly TRUE このプロパティの値は常に TRUE
値の ノートを参照してください。 このプロパティは、進行状況バー コントロールのテキストの進行状況を公開します。

 

必要なイベント

次の表は、進行状況バーがサポートするために必要な UI オートメーション イベントの一覧です。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI オートメーション イベント 筆記
UIA_AutomationFocusChangedEventId
プロパティ変更イベント UIA_BoundingRectanglePropertyId します。
プロパティ変更イベントを UIA_IsEnabledPropertyId します。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベント UIA_IsOffscreenPropertyId します。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベント UIA_NamePropertyId します。
UIA_StructureChangedEventId
プロパティ UIA_RangeValueValuePropertyId 変更されたイベントです。 コントロールが RangeValue コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベント UIA_ValueValuePropertyId します。 コントロールが Value コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。

 

概念

UI オートメーション コントロールの種類の概要

UI オートメーションの概要