更新 : 2007 年 11 月
ここでは、UI オートメーションによる ToolTip コントロール型のサポートに関する情報を示します。UI オートメーション では、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。
ツール ヒント コントロールは、テキストを含むポップアップ ウィンドウです。
以下のセクションでは、ToolTip コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのツール ヒント コントロールに適用されます。
このトピックには次のセクションが含まれています。
- 必須の UI オートメーション ツリー構造
- 必須の UI オートメーション プロパティ
- 必須の UI オートメーション コントロール パターン
- 必須の UI オートメーション イベント
- 関連トピック
必須の UI オートメーション ツリー構造
次の表では、ツール ヒント コントロールに関連した UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに何を格納できるかについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。
コントロール ビュー |
コンテンツ ビュー |
|---|---|
|
|
キーボード フォーカスを受け取ることができる場合、ツール ヒント コントロールは、UI オートメーション ツリーのコンテンツ ビューにのみ表示されます。それ以外の場合、ツール ヒントが参照している UI オートメーション要素の HelpTextProperty から、すべてのツール ヒントの情報を使用できます。
ツール ヒントは、その情報が参照しているコントロールの下に表示させる必要があります。クライアントは、ToolTipOpenedEvent をリッスンして、ツール ヒントに含まれる情報を常に取得できるようにする必要があります。
必須の UI オートメーション プロパティ
次の表に、値または定義が特にツール ヒント コントロールに関連する UI オートメーション プロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。
UI オートメーション プロパティ |
値 |
説明 |
|---|---|---|
AutomationIdProperty() |
説明を参照。 |
このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。 |
説明を参照。 |
コントロール全体を包含する外側の四角形。 |
|
説明を参照。 |
クリック可能なポイントは、コントロールを閉じるツール ヒントの一部にする必要があります。この機能を持たないツール ヒントもあり、この場合、クリック可能なポイントはありません。 |
|
説明を参照。 |
コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。 |
|
説明を参照。 |
ツール ヒント コントロールの名前は、ツール ヒント内に表示されるテキストと同じです。 |
|
Null |
ツール ヒント コントロールには、常にそのコンテンツによって自動的にラベルが付けられます。 |
|
ToolTip |
この値は、すべての UI フレームワークで共通です。 |
|
"tool tip" |
ToolTip コントロール型に対応するローカライズされた文字列。 |
|
依存 |
キーボード フォーカスを受け取ることができるツールヒント コントロールは、ツリーのコンテンツ ビュー内にある必要があります。テキストだけのときは、発生元のコントロールから HelpTextProperty として使用できます。 |
|
True |
ツール ヒント コントロールは、常にコントロールである必要があります。 |
|
Null |
HelpText プロパティは、ツール ヒント コントロールについて常に null になります。 |
必須の UI オートメーション コントロール パターン
ツール ヒント コントロールでサポートする必要がある UI オートメーション コントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。
コントロール パターン/パターン プロパティ |
サポート/値 |
説明 |
|---|---|---|
依存 |
UI 項目をクリックして閉じることができるツール ヒントは、WindowPattern をサポートして、自動的に閉じることができるようにする必要があります。 |
|
依存 |
一部の UI オートメーション プロバイダは、ツール ヒント コントロールの TextPattern を公開できません。 |
必須の UI オートメーション イベント
ツール ヒント コントロールは、画面に表示されたときに ToolTipOpenedEvent を発生させる必要があります。このイベントには、ツール ヒント自体の UI オートメーション要素への参照が含まれます。
すべてのツール ヒント コントロールでサポートする必要がある UI オートメーション イベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。
UI オートメーション イベント |
サポート |
説明 |
|---|---|---|
依存 |
なし |
|
依存 |
なし |
|
依存 |
なし |
|
依存 |
なし |
|
TooltipOpenedEvent() |
必須 |
なし |
TooltipClosedEvent() |
必須 |
なし |
BoundingRectangleProperty プロパティ変更イベント。 |
必須 |
なし |
IsOffscreenProperty プロパティ変更イベント。 |
必須 |
なし |
IsEnabledProperty プロパティ変更イベント。 |
必須 |
なし |
NameProperty プロパティ変更イベント。 |
必須 |
なし |
WindowVisualStateProperty プロパティ変更イベント。 |
依存 |
なし |
必須 |
なし |
|
必須 |
なし |