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