更新 : 2007 年 11 月
ここでは、UI オートメーションによる ToolBar コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型とはコントロールが ControlTypeProperty プロパティを使用するために満たしている必要のある一連の条件を表します。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。ツール バー コントロールは、エンド ユーザーがアプリケーション内のコマンドやツールをアクティブにするときに使用されます。
以下のセクションでは、ToolBar コントロール型の必須の UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォーム のいずれの場合でも、すべてのツール バー コントロールに当てはまります。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、ツール バー コントロールに関連した UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
|
ツール バー コントロールは、任意の種類のコントロールをサブツリー内に格納できます。よく使用されるのは、ボタン、コンボ ボックス、分割ボタンです。
必須の UI オートメーション プロパティ
次の表に、値または定義が特にツール バー コントロールに関連する UI オートメーションプロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
メモ |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
外接する四角形が存在する場合はサポートされます。外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
依存 |
1 つのアプリケーションで複数のツール バー コントロールを使用する場合を除いて、ツール バー コントロールに名前を付ける必要はありません。複数のツール バー コントロールが存在する場合は、それぞれの特徴がわかるような名前 ("書式設定"、"アウトライン" など) を付ける必要があります。 |
|
Null |
ツール バー コントロールにはラベルはありません。 |
|
ToolBar |
この値は、すべての UI フレームワークで共通です。 |
|
"tool bar" |
ToolBar コントロール型に対応するローカライズされた文字列。 |
|
True |
ツール バー コントロールは常にコンテンツです。 |
|
True |
ツール バー コントロールは、常にコントロールである必要があります。 |
必須の UI オートメーション コントロール パターン
ツール バー コントロールがサポートする必要がある UI オートメーション コントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
メモ |
|---|---|---|
依存 |
展開および折りたたむことによって多くの項目を表示できるツール バーの場合は、このパターンをサポートする必要があります。 |
|
依存 |
画面の別の部分にドッキングできるツール バーの場合は、このパターンをサポートする必要があります。 |
|
依存 |
サイズ変更、回転、移動が可能なツール バーの場合は、このパターンをサポートする必要があります。 |
必須の UI オートメーション イベント
すべてのツール バー コントロールがサポートする必要がある UI オートメーション イベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
メモ |
|---|---|---|
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
ExpandCollapseStateProperty プロパティ変更イベント。 |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |