次の方法で共有

ToolBar コントロールの種類

  • [アーティクル]

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

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

このトピックには、次のセクションが含まれています。

一般的なツリー構造

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

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

 

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

関連するプロパティ

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

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

 

必要なコントロール パターン

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

コントロール パターン 支える 筆記
IDockProviderの 依存 ツールバーを画面のさまざまな部分にドッキングできる場合は、Dock コントロール パターンをサポートする必要があります。
IExpandCollapseProviderをする 依存 ツールバーを展開および折りたたんでさらに項目を表示できる場合は、ExpandCollapse コントロール パターンをサポートする必要があります。
ITransformProviderの 依存 ツールバーのサイズ変更、回転、または移動が可能な場合は、Transform コントロール パターンをサポートする必要があります。

 

必要なイベント

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

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

 

概念

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

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