AddHyperlink(String,IList<TextRun>,String) メソッド

現在の段落へテキスト ハイパーリンクを追加します。

シンタックス

Visual Basic

'宣言
 
Public Overloads Sub AddHyperlink( _
   ByVal address As String, _
   ByVal textRuns As IList(Of TextRun), _
   ByVal toolTipText As String _
) 

C#

public void AddHyperlink( 
   string address,
   IList<TextRun> textRuns,
   string toolTipText
)

パラメータ

address

ハイパーリンクのアドレス。

textRuns

ハイパーリンクのリッチ コンテンツを定義する TextRun インスタンスの一覧。

toolTipText

ユーザーがこのハイパーリンクの上にカーソルでホバーときに表示されるテキスト。

例外

例外	解説
WordDocumentWriterException	現在開いている文書または段落がない場合スローされます。
WordDocumentWriterXmlWriterException	XmlWriter が例外をスローするストリームへコンテンツを書き込むために使用された場合スローされます。

解説

このオーバー読み込みにより、ハイパーリンクにフォント属性を混合したテキストで表示できます。異なるフォント属性のある各テキスト部分は、別々のテキスト ランとして明示される必要があります。それぞれがメソッドを呼び出す前に textRuns リストに追加されます。

AddHyperlink メソッドが呼び出される前に、開発者は StartParagraph メソッドを介して段落を開始するか例外をスローする必要があります。

address が "www." で始まる場合、プレフィックス "http://" を追加することで無効な URL の作成を防ぐことができます。