UI オートメーションによる StatusBar コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、StatusBar コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある条件のセットのことです。 この条件には、UI オートメーション ツリーの構造、UI オートメーションのプロパティ値、コントロール パターンに関する特定のガイドラインが含まれます。
ステータス バー コントロールは、アプリケーションのウィンドウに表示されているオブジェクトの情報、そのオブジェクトのコンポーネント、またはそのオブジェクトのアプリケーション内での操作に関連するコンテキストについての情報を表示します。
以降のセクションでは、StatusBar コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、イベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれにおいても、すべてのステータス バー コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、ステータス バー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| StatusBar - Edit (0 以上) - ProgressBar (0 以上) - Image (0 以上) - Button (0 以上) |
StatusBar - Edit (0 以上) - ProgressBar (0 以上) - Image (0 以上) - Button (0 以上) |
必須の UI オートメーション プロパティ
次の表に、進行状況バー コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | ステータス バーの四角形領域は、ステータス バー コントロールに含まれるコントロールをすべて囲んでいる必要があります。 |
| ClickablePointProperty | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | アプリケーション内で複数のステータス バー コントロールが使用されている場合を除き、ステータス バー コントロールに名前は必要ありません。 複数のステータス バー コントロールが使用されている場合は、「インターネットの状態」や「アプリケーションの状態」などの名前で各バーを区別します。 |
| LabeledByProperty | Null |
通常、ステータス バー コントロールにラベルはありません。 |
| ControlTypeProperty | StatusBar | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | 「ステータス バー」 | StatusBar コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | ○ | ステータス バー コントロールには、常にコンテンツが含まれます。 |
| IsControlElementProperty | ○ | ステータス バー コントロールは、常にコントロールです。 |
| IsOffscreenProperty | 依存 | ステータス バー コントロールは、現在画面上に表示されていなければこのプロパティに True を返します。 |
| OrientationProperty | 依存 | コントロールの向きを示す値 (水平または垂直)。 |
| IsKeyboardFocusableProperty | × | 適用できません |
| AcceleratorKeyProperty | Null |
ステータス バーにアクセラレータ キーはありません。 |
必須の UI オートメーション コントロール パターン
次の表に、ステータス バー コントロールでサポートされる必要がある UI オートメーション コントロールのパターンを示します。 コントロール パターンについて詳しくは、「 UI Automation Control Patterns Overview」をご覧ください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| IGridProvider | 省略可能 | 個々の項目を監視して簡単に情報を参照できるように、ステータス バー コントロールはグリッド コントロール パターンをサポートする必要があります。 |
必須の UI オートメーション イベント
次の表に、すべてのステータス バー コントロールでサポートされる必要がある UI オートメーション イベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |