UI オートメーションによる ToolBar コントロール型のサポート

メモ
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージ UI Automation クラスを使用する .NET Framework 開発者を対象としています。UI Automationに関する最新情報については、「Windows Automation API: UI Automation (Windows オートメーション API: UI オートメーション)」を参照してください。

ここでは、UI Automationによる ToolBar コントロール型のサポートに関する情報を示します。 UI Automationでは、コントロール型とはコントロールが ControlTypeProperty プロパティを使用するために満たしている必要のある一連の条件を表します。 これらの条件には、UI Automation ツリー構造、UI Automationのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。ツール バー コントロールは、エンド ユーザーがアプリケーション内のコマンドやツールをアクティブにするときに使用されます。

以下のセクションでは、ToolBar コントロール型の必須の UI Automation ツリー構造、プロパティ、コントロール パターン、およびイベントを示します。 UI Automationの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows Forms のいずれの場合でも、すべてのツール バー コントロールに当てはまります。

このトピックは、次のセクションで構成されています。

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

次の表では、ツール バー コントロールに関連した UI Automation ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。 UI Automation ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー	コンテンツ ビュー
ToolBar 各種コントロール (0 以上)	ToolBar 各種コントロール (0 以上)

ツール バー コントロールは、任意の種類のコントロールをサブツリー内に格納できます。 よく使用されるのは、ボタン、コンボ ボックス、分割ボタンです。

必須の UI オートメーション プロパティ

次の表に、値または定義が特にツール バー コントロールに関連する UI Automationプロパティを示します。 UI Automation プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI Automation プロパティ	値	説明
AutomationIdProperty	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	説明を参照。	コントロール全体を包含する外側の四角形。
ClickablePointProperty	説明を参照。	外接する四角形が存在する場合はサポートされます。 外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。
IsKeyboardFocusableProperty	説明を参照。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	依存	1 つのアプリケーションで複数のツール バー コントロールを使用する場合を除いて、ツール バー コントロールに名前を付ける必要はありません。 複数のツール バー コントロールが存在する場合は、それぞれの特徴がわかるような名前 ("書式設定"、"アウトライン" など) を付ける必要があります。
LabeledByProperty	Null	ツール バー コントロールにはラベルはありません。
ControlTypeProperty	ToolBar	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"tool bar"	ToolBar コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	True	ツール バー コントロールは常にコンテンツです。
IsControlElementProperty	True	ツール バー コントロールは、常にコントロールである必要があります。

必須の UI オートメーション コントロール パターン

ツール バー コントロールがサポートする必要がある UI Automation コントロール パターンの一覧を次の表に示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

コントロール パターン	サポート	説明
ExpandCollapsePattern	依存	展開および折りたたむことによって多くの項目を表示できるツール バーの場合は、このパターンをサポートする必要があります。
DockPattern	依存	画面の別の部分にドッキングできるツール バーの場合は、このパターンをサポートする必要があります。
TransformPattern	依存	サイズ変更、回転、移動が可能なツール バーの場合は、このパターンをサポートする必要があります。

必須の UI オートメーション イベント

すべてのツール バー コントロールがサポートする必要がある UI Automation イベントを次の表に示します。 イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI Automation イベント	サポート	説明
BoundingRectangleProperty プロパティ変更イベント	必須	なし
IsOffscreenProperty プロパティ変更イベント	必須	なし
IsEnabledProperty プロパティ変更イベント	必須	なし
ExpandCollapseStateProperty プロパティ変更イベント	依存	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

参照

ToolBar

概念

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

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