ToolTip コントロールの種類
このトピックでは、ToolTip コントロールの種類に対する Microsoft UI オートメーションのサポートについて説明します。 ヒント コントロールは、テキストを含むポップアップ ウィンドウです。
次のセクションでは、ToolTip コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンに対する UI オートメーションのサポートを統合するすべてのツールヒント コントロールに適用されます。
このトピックには、次のセクションが含まれています。
- 一般的なツリー構造の
- 関連するプロパティ を する
- 必要なコントロール パターンの
- 必要なイベント を する
- 関連トピック
一般的なツリー構造
次の表は、ツールヒント コントロールに関連する UI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー | コンテンツ ビュー |
---|---|
|
|
ツールヒント コントロールは、キーボード フォーカスを受け取ることができる場合、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 コントロール パターンをサポートしている場合は、このイベントをサポートする必要があります。 |
関連トピック