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