UI オートメーションによる Hyperlink コントロール型のサポート

更新 : 2007 年 11 月

ここでは、UI オートメーションによる Hyperlink コントロール型のサポートに関する情報を示します。UI オートメーションでは、コントロール型は、ControlTypeProperty プロパティを使用するためにコントロールで満たす必要がある一連の条件となります。これらの条件には、UI オートメーション ツリー構造、UI オートメーションのプロパティ値、およびコントロール パターンに関する特定のガイドラインが含まれます。

ハイパーリンク コントロールを使用すると、ユーザーは、ページ内やページ間を移動したり、ウィンドウを開いたりできます。

以下のセクションでは、Hyperlink コントロール型で必要な UI オートメーション ツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。UI オートメーションの各要件は、Windows Presentation Foundation (WPF)、Win32、Windows フォームのいずれの場合でも、すべてのハイパーリンク コントロールに当てはまります。

このトピックには次のセクションが含まれています。

• 必須の UI オートメーション ツリー構造
• 必須の UI オートメーション プロパティ
• 必須の UI オートメーション コントロール パターン
• 必須の UI オートメーション イベント
• 関連トピック

必須の UI オートメーション ツリー構造

次の表では、ハイパーリンク コントロールに関連する UI オートメーション ツリーのコントロール ビューとコンテンツ ビューを示し、各ビューに格納できるものについて説明します。UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー	コンテンツ ビュー
Hyperlink	Hyperlink

必須の UI オートメーション プロパティ

次の表に、値または定義が特に Hyperlink コントロール型に関連する UI オートメーション プロパティを示します。UI オートメーション プロパティの詳細については、「クライアントの UI オートメーション プロパティ」を参照してください。

UI オートメーション プロパティ	値	説明
AutomationIdProperty()	説明を参照。	このプロパティの値は、アプリケーションのすべてのコントロールで一意にする必要があります。
BoundingRectangleProperty	説明を参照。	コントロール全体を包含する外側の四角形。
ClickablePointProperty	説明を参照。	外接する四角形が存在する場合はサポートされます。外接する四角形の範囲内にクリック不可能な点が存在するときに特別なヒット テストを実行する場合は、クリック可能な点をオーバーライドして提供します。
IsKeyboardFocusableProperty	説明を参照。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
NameProperty	説明を参照。	ハイパーリンク コントロールの名前は、画面上に下線付きで表示されるテキストです。
ClickablePointProperty	説明を参照。	ハイパーリンク コントロールのクリック可能なポイントは、マウス ポインタでクリックされるとハイパーリンクを起動するポイントでなければなりません。
LabeledByProperty	Null	静的テキスト ラベルが存在する場合、このプロパティは、該当するコントロールへの参照を公開する必要があります。
ControlTypeProperty	Hyperlink	この値は、すべての UI フレームワークで共通です。
LocalizedControlTypeProperty	"ハイパーリンク"	Hyperlink コントロール型に対応するローカライズされた文字列。
IsContentElementProperty	True	ハイパーリンク コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。
IsControlElementProperty	True	ハイパーリンク コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。

必須の UI オートメーション コントロール パターン

すべてのハイパーリンク コントロールでサポートする必要がある UI オートメーション コントロール パターンの一覧を次の表に示します。コントロール パターンの詳細については、「UI オートメーション コントロール パターンの概要」を参照してください。

コントロール パターン/パターン プロパティ	サポート/値	説明
IInvokeProvider	○	すべてのハイパーリンク コントロールは、呼び出しパターンをサポートする必要があります。

必須の UI オートメーション イベント

すべてのハイパーリンク コントロールでサポートする必要がある UI オートメーション イベントを次の表に示します。イベントの詳細については、「UI オートメーション イベントの概要」を参照してください。

UI オートメーション イベント	サポート	説明
InvokedEvent	必須	なし
BoundingRectangleProperty プロパティ変更イベント。	必須	なし
IsOffscreenProperty プロパティ変更イベント。	必須	なし
IsEnabledProperty プロパティ変更イベント。	必須	なし
AutomationFocusChangedEvent	必須	なし
StructureChangedEvent	必須	なし

参照

概念

UI オートメーション コントロール型の概要

UI オートメーションの概要

参照

Hyperlink