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