ツールヒント コントロールの種類

  • [アーティクル]

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

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

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

一般的なツリー構造

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

コントロール ビュー コンテンツ ビュー
  • ToolTip
    • テキスト (0 以上)
    • イメージ (0 個以上)
  • ヒント

 

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

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

関連するプロパティ

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

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

 

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

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

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

 

必須イベント

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

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

UI オートメーション イベント Notes
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 オートメーションの概要