ToolBar コントロールの種類

  • [アーティクル]

このトピックでは、ToolBar コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。 ツール バー コントロールを使用すると、エンド ユーザーはアプリケーションに含まれるコマンドとツールをアクティブ化できます。

次のセクションでは、ToolBar コントロール型に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのツール バー コントロールに適用されます。

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

一般的なツリー構造

次の表は、ツール バー コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容について説明します。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

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

 

ツール バー コントロールには、そのサブツリー内の任意の種類のコントロールを含めることができます。 ほとんどの場合は、ボタン、コンボ ボックス、およびスプリット ボタンが含まれています。

関連するプロパティ

次の表に、値または定義が ToolBar コントロール型に特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からのプロパティの取得」を参照してください。

UI Automation のプロパティ 値 メモ
UIA_AutomationIdPropertyId 「ノート」を参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素間で一意である必要があります。
UIA_BoundingRectanglePropertyId 「ノート」を参照してください。 コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId 「ノート」を参照してください。 四角形領域が存在する場合にサポートされます。 外接する四角形内のすべてのポイントがクリック可能でなく、要素が特殊なヒット テストを実行する場合は、オーバーライドしてクリック可能なポイントを指定します。
UIA_ControlTypePropertyId ToolBar この値は、すべての UI フレームワークで同じです。
UIA_IsContentElementPropertyId true ツール バー コントロールは、常にUI オートメーション ツリーのコンテンツ ビューに含まれます。
UIA_IsControlElementPropertyId true ツール バー コントロールは、常にUI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId 「ノート」を参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId NULL ツール バー コントロールにラベルが付くことはありません。
UIA_LocalizedControlTypePropertyId 「ノート」を参照してください。 ToolBar コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ツール バー" です。
UIA_NamePropertyId 依存 アプリケーション内で複数のコントロールを使用しない限り、ツール バー コントロールには名前は必要ありません。 複数の名前が存在する場合は、それぞれ識別名 ("書式設定" や "アウトライン" など) を持っている必要があります。

 

必須のコントロール パターン

次の表に、ツール バー コントロールでサポートするために必要なUI オートメーションコントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロール パターン サポート Notes
IDockProvider 依存 ツール バーを画面のさまざまな部分にドッキングできる場合は、 Dock コントロール パターンをサポートする必要があります。
IExpandCollapseProvider 依存 ツールバーを展開したり折りたたんだりして他の項目を表示できる場合は、 ExpandCollapse コントロール パターンをサポートする必要があります。
ITransformProvider 依存 ツール バーのサイズを変更、回転、または移動できる場合は、 変換 コントロール パターンをサポートする必要があります。

 

必須イベント

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

UI オートメーション イベント メモ
UIA_AutomationFocusChangedEventId
プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。
プロパティ変更イベントUIA_ExpandCollapseExpandCollapseStatePropertyId します。 コントロールが ExpandCollapse コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_IsEnabledPropertyId 変更されたイベントです。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

概念

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

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