注
このドキュメントは、System.Windows.Automation 名前空間で定義されているマネージド UI オートメーション クラスを使用する .NET Framework 開発者を対象としています。 UI オートメーションの最新情報については、「Windows Automation API: UI オートメーション 」を参照してください。
このトピックでは、ツールヒント コントロールの種類に対する UI オートメーションのサポートについて説明します。 UI オートメーションでは、コントロール型は、 ControlTypeProperty プロパティを使用するためにコントロールが満たす必要がある一連の条件です。 条件には、UI オートメーション ツリー構造、UI オートメーション プロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
ツール ヒント コントロールは、テキストを含むポップアップ ウィンドウです。
次のセクションでは、ToolTip コントロール型に必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれであっても、すべてのツール ヒント コントロールに適用されます。
必要な UI オートメーション ツリー構造
次の表は、ツール ヒント コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「 UI オートメーション ツリーの概要」を参照してください。
| コントロール ビュー | コンテンツ ビュー |
|---|---|
| ツールヒント - テキスト (0 以上) - 画像 (0 以上) |
ツールヒント |
ツール ヒント コントロールは、キーボード フォーカスを受け取ることができる場合、UI オートメーション ツリーのコンテンツ ビューにのみ表示されます。 それ以外の場合、ツール ヒントの情報はすべて、ツール ヒントが参照している UI オートメーション要素の HelpTextProperty から入手できます。
ツール ヒントは、情報が参照しているコントロールの下に表示されます。 クライアントは、ツール ヒントに含まれる情報を一貫して取得できるように、 ToolTipOpenedEvent をリッスンする必要があります。
必要な UI オートメーション プロパティ
次の表に、ツール ヒント コントロールに特に関連する値または定義を持つ UI オートメーション プロパティの一覧を示します。 UI オートメーション プロパティの詳細については、「 クライアントの UI オートメーション プロパティ」を参照してください。
| UI オートメーション プロパティ | 価値 | 注記 |
|---|---|---|
| AutomationIdProperty | 「ノート」を参照してください。 | このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。 |
| BoundingRectangleProperty | 「ノート」を参照してください。 | コントロール全体を格納する最も外側の四角形。 |
| ClickablePointProperty | 「ノート」を参照してください。 | クリック可能なポイントは、コントロールを閉じるツール ヒントの一部である必要があります。 一部のツール ヒントには、この機能がないため、クリック可能なポイントはありません。 |
| IsKeyboardFocusableProperty | 「ノート」を参照してください。 | コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
| NameProperty | 「ノート」を参照してください。 | ツール ヒント コントロールの名前は、ツール ヒント内に表示されるテキストです。 |
| LabeledByProperty | Null |
ツール ヒント コントロールは、常にコンテンツによって自己ラベル付けされます。 |
| ControlTypeProperty | ツールヒント | この値は、すべての UI フレームワークで同じです。 |
| LocalizedControlTypeProperty | "ツール ヒント" | ToolTip コントロール型に対応するローカライズされた文字列。 |
| IsContentElementProperty | 依存 | ツール ヒント コントロールがキーボード フォーカスを受け取ることができる場合は、ツリーのコンテンツ ビューに表示されている必要があります。 テキストのみの場合は、それを発生させたコントロールの HelpTextProperty として使用できます。 |
| IsControlElementProperty | 正しい | ツール ヒント コントロールは常にコントロールである必要があります。 |
必要な UI オートメーション コントロール パターン
次の表に、ツール ヒント コントロールでサポートするために必要な UI オートメーション コントロール パターンの一覧を示します。 コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
| コントロール パターン | 支援 | 注記 |
|---|---|---|
| IWindowProvider | 依存 | UI 項目をクリックして閉じることができるツール ヒントは、自動的に閉じることができるように WindowPattern をサポートしている必要があります。 |
| ITextProvider | 依存 | アクセシビリティを向上するために、ツール ヒント コントロールはテキスト コントロール パターンをサポートできますが、必須ではありません。 テキスト コントロール パターンは、テキストに豊富なスタイルと属性 (色、太字、斜体など) がある場合に便利です。 |
必要な UI オートメーション イベント
ツール ヒント コントロールは、画面に表示されるときに ToolTipOpenedEvent を上げる必要があります。 このイベントには、ツール ヒント自体の UI オートメーション要素への参照が含まれます。
次の表に、すべてのツール ヒント コントロールでサポートされる必要がある UI オートメーション イベントの一覧を示します。 イベントの詳細については、「 UI オートメーション イベントの概要」を参照してください。
| UI オートメーション イベント | 支援 | 注記 |
|---|---|---|
| TextSelectionChangedEvent | 依存 | 無し |
| TextChangedEvent | 依存 | 無し |
| WindowClosedEvent | 依存 | 無し |
| WindowOpenedEvent | 依存 | 無し |
| ToolTipOpenedEvent | 必須 | 無し |
| ToolTipClosedEvent | 必須 | 無し |
| BoundingRectangleProperty プロパティ変更イベント。 | 必須 | 無し |
| IsOffscreenProperty プロパティ変更イベント。 | 必須 | 無し |
| IsEnabledProperty プロパティ変更イベント。 | 必須 | 無し |
| NameProperty プロパティ変更イベント。 | 必須 | 無し |
| WindowVisualStateProperty プロパティ変更イベント。 | 依存 | 無し |
| AutomationFocusChangedEvent | 必須 | 無し |
| StructureChangedEvent | 必須 | 無し |