ハイパーリンク コントロールの種類

このトピックでは、ハイパーリンク コントロールの種類に対する Microsoft UI オートメーション のサポートについて説明します。

ハイパーリンク コントロールは、ユーザーが同じページ内、またはあるページから別のページに移動できるようにするリンクを作成します。

次のセクションでは、Hyperlink コントロールの種類に必要なUI オートメーションツリー構造、プロパティ、コントロール パターン、およびイベントを定義します。 UI オートメーションの要件は、UI フレームワーク/プラットフォームがコントロールの種類とコントロール パターンのサポートUI オートメーション統合するすべてのハイパーリンク コントロールに適用されます。

このトピックは、次のセクションで構成されています。

• 一般的なツリー構造
• 関連するプロパティ
• 必須のコントロール パターン
• 必須イベント
• 解説
• 関連トピック

一般的なツリー構造

次の表は、ハイパーリンク コントロールに関連するUI オートメーション ツリーの一般的なコントロールとコンテンツ ビューを示し、各ビューに含めることができる内容を示しています。 UI オートメーション ツリーの詳細については、「UI オートメーション ツリーの概要」を参照してください。

コントロール ビュー	コンテンツ ビュー
ハイパーリンク	ハイパーリンク

 

関連するプロパティ

次の表に、値または定義がハイパーリンク コントロールに特に関連するUI オートメーションプロパティの一覧を示します。 UI オートメーションプロパティの詳細については、「UI オートメーション要素からプロパティを取得する」を参照してください。

UI Automation のプロパティ	値	Notes
UIA_AutomationIdPropertyId	「ノート」を参照してください。	このプロパティの値は、アプリケーション内のすべてのコントロールで一意である必要があります。
UIA_BoundingRectanglePropertyId	「ノート」を参照してください。	コントロール全体を格納する最も外側の四角形。
UIA_ClickablePointPropertyId	「ノート」を参照してください。	ハイパーリンク コントロールのクリック可能なポイントは、マウス ポインターでクリックした場合にハイパーリンクを起動するポイントである必要があります。
UIA_ControlTypePropertyId	ハイパーリンク
UIA_IsContentElementPropertyId	true	このハイパーリンク コントロールは、UI オートメーション ツリーのコンテンツ ビューに常に含まれます。
UIA_IsControlElementPropertyId	true	このハイパーリンク コントロールは、UI オートメーション ツリーのコントロール ビューに常に含まれます。
UIA_IsKeyboardFocusablePropertyId	「ノート」を参照してください。	コントロールがキーボード フォーカスを受け取ることができる場合は、このプロパティをサポートする必要があります。
UIA_LabeledByPropertyId	「ノート」を参照してください。	静的テキスト ラベルがある場合、このプロパティは、そのコントロールへの参照を公開する必要があります。
UIA_LocalizedControlTypePropertyId	「ノート」を参照してください。	Hyperlink コントロールの種類に対応するローカライズされた文字列。 既定値は、en-US または英語 (米国) の "ハイパーリンク" です。
UIA_NamePropertyId	「ノート」を参照してください。	ハイパーリンク コントロールの名前は、画面に下線付きで表示されるテキストです。

 

必須のコントロール パターン

次の表に、ハイパーリンク コントロールがサポートするために必要なUI オートメーション コントロール パターンを示します。 コントロール パターンの詳細については、「 UI Automation Control Patterns Overview」を参照してください。

コントロール パターン/パターン プロパティ	サポート/値	Notes
IInvokeProvider	必須	すべてのハイパーリンク コントロールは、 Invoke コントロール パターンをサポートしている必要があります。
IValueProvider	依存	ハイパーリンク コントロールは、リンクにユーザーにとって有用な情報が含まれている場合に 、値 コントロール パターンをサポートする必要があります。
Value	たとえば、"https://www..."	インターネットまたはイントラネット アドレスの URL は、ユーザーにとって意味のある情報を含むハイパーリンクの例です。 ただし、プログラムリンクはアプリケーションに対してのみ意味があり、 Value プロパティにはお勧めしません。

 

必須イベント

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

UI オートメーション イベント	Notes
UIA_AutomationFocusChangedEventId
プロパティUIA_BoundingRectanglePropertyId 変更されたイベントです。
UIA_Invoke_InvokedEventId
プロパティUIA_IsEnabledPropertyId 変更されたイベントです。	コントロールが IsEnabled プロパティをサポートしている場合は、このイベントをサポートする必要があります。
プロパティUIA_IsOffscreenPropertyId 変更されたイベントです。	コントロールが IsOffscreen プロパティをサポートしている場合は、このイベントをサポートする必要があります。
UIA_StructureChangedEventId

 

解説

Hyperlink コントロールの種類は、クリックするとナビゲーションが発生するオブジェクトにのみ適用する必要があります。ハイパーリンクのコンテナーには適用しないでください。 たとえば、イメージ マップ内のクリック可能な "ホット スポット" にのみ 、ハイパーリンク コントロールの種類を指定する必要があります。 同じことが、テキスト フィールドまたはドキュメント コンテナー内のハイパーリンクにも当てはまります。 この場合、ハイパーリンク テキストまたはイメージにのみ、コンテナーではなく Hyperlink コントロールの種類を指定する必要があります。

テキスト コントロール パターンは、 テキスト 要素またはドキュメント要素に埋め込まれたハイパーリンクをサポートするのに最適です。

関連トピック

概念

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

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