StatusBar コントロールの種類
このトピックでは、StatusBar コントロール型の Microsoft UI オートメーション サポートについて説明します。
ステータス バー コントロールは、アプリケーションのウィンドウに表示されているオブジェクトの情報、そのオブジェクトのコンポーネント、またはそのオブジェクトのアプリケーション内での操作に関連するコンテキストについての情報を表示します。
次のセクションでは、StatusBar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーション要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのステータス バー コントロールに適用されます。
このトピックは、次のセクションで構成されています。
一般的なツリー構造
次の表は、ステータス バー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
|
|
関連するプロパティ
次の表に、値または定義がステータス バー コントロールに特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。
| UI Automation のプロパティ | 値 | メモ |
|---|---|---|
| UIA_AutomationIdPropertyId | 「ノート」を参照してください。 | このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。 |
| UIA_BoundingRectanglePropertyId | 「ノート」を参照してください。 | ステータス バーの四角形領域は、ステータス バー コントロールに含まれるコントロールをすべて囲んでいる必要があります。 |
| UIA_ClickablePointPropertyId | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 外接する四角形内にクリックできない領域があり、要素が特殊なヒット テストを実行する場合は、これをオーバーライドしてクリック可能なポイントを指定します。 |
| UIA_ControlTypePropertyId | StatusBar | |
| UIA_IsContentElementPropertyId | true | ステータス バー コントロールは、常にUI オートメーション ツリーのコンテンツ ビューに含まれます。 |
| UIA_IsControlElementPropertyId | true | ステータス バー コントロールは、常にUI オートメーション ツリーのコントロール ビューに含まれます。 |
| UIA_IsKeyboardFocusablePropertyId | 依存 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| UIA_IsOffscreenPropertyId | 依存 | ステータス バー コントロールが現在表示されていない場合、このプロパティの TRUE が返されます。 |
| UIA_LabeledByPropertyId | NULL | 通常、ステータス バー コントロールにはラベルがありません。 |
| UIA_LocalizedControlTypePropertyId | 「ノート」を参照してください。 | StatusBar コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ステータス バー" です。 |
| UIA_NamePropertyId | 「ノート」を参照してください。 | アプリケーション内で複数のステータス バー コントロールが使用されている場合を除き、ステータス バー コントロールに名前は必要ありません。 この場合は、各バーを "Internet Status" や "Application Status" などの名前で区別します。 |
| UIA_OrientationPropertyId | 依存 | コントロールの向き (水平または垂直) を示す値。 |
必須のコントロール パターン
次の表に、ステータス バー コントロールでサポートするために必要なUI オートメーションコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| IGridProvider | オプション | ステータス バー コントロールは、個々の要素を監視し、情報を簡単に参照できるように 、グリッド コントロール パターンをサポートする必要があります。 |
必須イベント
次の表に、ステータス バー コントロールがサポートするために必要なUI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | メモ |
|---|---|
| UIA_AutomationFocusChangedEventId | |
| プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。 | |
| プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 | コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 | コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。 |
| UIA_StructureChangedEventId |
注釈
ステータス バーでは、編集コントロールを子グリッド要素として使用することをお勧めします。 編集コントロールを使用すると、要素の名前と値のプロパティを使用して、状態フィールドの目的をその値に簡単に関連付けることができます。 テキスト コントロールは Value コントロール パターンをサポートしていないので、子グリッド要素として使用しないでください。
関連トピック