UI オートメーションによる ToolBar コントロール型のサポート
Note
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、Windows Automation API の「UI オートメーション」を参照してください。
このトピックでは、ToolBar コントロール型に対する UI オートメーションのサポートに関する情報を提供します。 UI オートメーションでのコントロール型とは、コントロールで ControlTypeProperty プロパティを使用するために満たす必要がある一連の条件のことです。 この条件には、UI オートメーションのツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。 ツール バー コントロールを使用すれば、エンドユーザーは、アプリケーション内に含まれるコマンドやツールをアクティブにすることができます。
以降のセクションでは、ToolBar コントロール型に必要な UI オートメーションのツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 この UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、または Windows フォームのいずれかにおけるすべてのツール バー コントロールに適用されます。
必須の UI オートメーション ツリー構造
次の表に、ツール バー コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、それぞれのビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| ToolBar - 各種コントロール (0 以上) |
ToolBar - 各種コントロール (0 以上) |
ツール バー コントロールには、そのサブツリー内に任意の型のコントロールを含めることができます。 ほとんどの場合は、ボタン、コンボ ボックス、およびスプリット ボタンが含まれています。
必須の UI オートメーション プロパティ
次の表に、ツール バー コントロールに特に関連する値または定義を持つ UI オートメーション プロパティを示します。 UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
| UI Automation のプロパティ | 値 | Notes |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | 四角形領域が存在する場合にサポートされます。 四角形領域内にクリック不可能な点が存在し、特別なヒット テストを実行する場合は、オーバーライドしてクリック可能な点を提供します。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 依存 | アプリケーション内で複数のツール バー コントロールが使用されている場合を除き、ツール バー コントロールに名前は必要ありません。 複数のツール バー コントロールが存在する場合は、それぞれに特徴的な名前 (Formatting や Outlining など) を付ける必要があります。 |
| LabeledByProperty | Null |
ツール バー コントロールにラベルはありません。 |
| ControlTypeProperty | ToolBar | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "tool bar" | ToolBar コントロール型に対応する、ローカライズされた文字列。 |
| IsContentElementProperty | ○ | ツール バー コントロールは常にコンテンツです。 |
| IsControlElementProperty | ○ | ツール バー コントロールは、常にコントロールである必要があります。 |
必須の UI オートメーション コントロール パターン
次の表に、ツール バー コントロールでサポートされなければならない UI オートメーションのコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。
| コントロール パターン | サポート | Notes |
|---|---|---|
| ExpandCollapsePattern | 依存 | ツール バーを展開または折りたたむことでさらに多くの項目を表示可能な場合は、このパターンをサポートする必要があります。 |
| DockPattern | 依存 | ツール バーを画面のさまざまな部分にドッキング可能な場合は、このパターンをサポートする必要があります。 |
| TransformPattern | 依存 | ツール バーをサイズ変更、回転、または移動可能な場合は、このパターンをサポートする必要があります。 |
必須の UI オートメーション イベント
次の表に、すべてのツール バー コントロールでサポートされなければならない UI オートメーションのイベントを示します。 イベントの詳細については、「 UI Automation Events Overview」を参照してください。
| UI オートメーション イベント | サポート | Notes |
|---|---|---|
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | なし |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | なし |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | なし |
| ExpandCollapseStateProperty プロパティ変更イベント。 | 依存 | なし |
| AutomationFocusChangedEvent | 必須 | なし |
| StructureChangedEvent | 必須 | なし |