次の方法で共有

ToolTip コントロールの種類

  • [アーティクル]

このトピックでは、ToolTip コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。 ヒント コントロールは、テキストを含むポップアップ ウィンドウです。

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • ツールヒント
    • テキスト (0 以上)
    • 画像 (0 以上)
  • ツールヒント

 

ツールヒント コントロールは、キーボード フォーカスを受け取ることができる場合、UI オートメーション ツリーのコンテンツ ビューにのみ表示されます。 それ以外の場合、ツールヒントの情報はすべて、ツールヒントが参照している要素の IUIAutomationElement::CurrentHelpText (または CachedHelpText) プロパティから入手できます。

ヒントは、情報が参照されているコントロールの下に表示されます。 クライアントは、ツールヒントに含まれる情報を一貫して取得できるように、UIA_ToolTipOpenedEventId をリッスンする必要があります。

関連するプロパティ

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

UI オートメーション プロパティ 価値 筆記
UIA_AutomationIdPropertyId ノートを参照してください。 このプロパティの値は、UI オートメーション ツリーの生ビュー内のすべてのピア要素で一意である必要があります。
UIA_BoundingRectanglePropertyId ノートを参照してください。 コントロール全体を含む最も外側の四角形。
UIA_ClickablePointPropertyId ノートを参照してください。 クリック可能なポイントは、コントロールを閉じるツールヒントの一部である必要があります。 一部のツールヒントにはこの機能がないため、クリック可能なポイントはありません。
UIA_ControlTypePropertyId ツールヒントの
UIA_IsContentElementPropertyId 依存 ツールヒント コントロールがキーボード フォーカスを受け取ることができる場合は、ツリーのコンテンツ ビューに表示される必要があります。 テキストのみの場合は、IUIAutomationElement::CurrentHelpText (または、それを発生させたコントロールの CachedHelp Text)) プロパティとして使用できます。
UIA_IsControlElementPropertyId 真 ツールヒント コントロールは、常に UI オートメーション ツリーのコントロール ビューに含まれます。
UIA_IsKeyboardFocusablePropertyId ノートを参照してください。 コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId ヌル ツールヒント コントロールは、常にコンテンツによって自己ラベル付けされます。
UIA_LocalizedControlTypePropertyId ノートを参照してください。 ToolTip コントロール型に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ツールヒント" です。
UIA_NamePropertyId ノートを参照してください。 ツールヒント コントロールの名前は、ツールヒント内に表示されるテキストです。

 

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

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

コントロール パターン 支える 筆記
ITextProviderの 依存 アクセシビリティを向上するために、ツールヒント コントロールは、Text コントロール パターンをサポートできますが、必須ではありません。 テキスト コントロール パターンは、テキストに豊富なスタイルと属性 (色、太字、斜体など) がある場合に便利です。
IWindowProviderの 依存 UI 項目をクリックして閉じることができるツールヒントは、自動的に閉じることができるように、ウィンドウ コントロール パターンをサポートしている必要があります。

 

必要なイベント

ツールヒント コントロールは、画面に表示されたときに UIA_ToolTipOpenedEventId イベントを発生させる必要があります。 イベントには、ツールヒント自体の UI オートメーション要素への参照が含まれます。

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

UI オートメーション イベント 筆記
UIA_AutomationFocusChangedEventId
プロパティ変更イベント UIA_BoundingRectanglePropertyId します。
プロパティ変更イベントを UIA_IsEnabledPropertyId します。 コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベント UIA_IsOffscreenPropertyId します。 コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ変更イベント UIA_NamePropertyId します。
UIA_Text_TextChangedEventId コントロールが Text コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA_ToolTipClosedEventId
UIA_ToolTipOpenedEventId
UIA_StructureChangedEventId
UIA_Window_WindowClosedEventId コントロールが Window コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
UIA_Window_WindowOpenedEventId コントロールが Window コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。
プロパティ UIA_WindowWindowVisualStatePropertyId 変更されたイベントです。 コントロールが Window コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。

 

概念

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

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