次の方法で共有

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

  • [アーティクル]

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

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

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

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

一般的なツリー構造

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

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

 

関連するプロパティ

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

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

 

必要なコントロール パターン

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

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

 

必要なイベント

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

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

 

備考

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

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

概念

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

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