PDF ドキュメントへのリンクの追加

PDF の仕様では、複数の種類の注釈をドキュメントに追加できます。注釈は通常、強調や注として手作業で追加されます。注釈はプログラムによって追加することもできます。 C1PdfDocument には、ハイパーリンク、ハイパーリンクターゲット、および添付ファイルを PDF ドキュメントに追加するためのメソッドが用意されています。

ハイパーリンクをドキュメントに追加するには、C1PdfDocument.AddLink メソッドを使用します。C1PdfDocument.AddLink メソッドは、２つのパラメータ（url を示す文字列と、リンクとして動作して現在のページ上の領域を示す Rect）を受け取ります。

C1PdfDocument.AddLink メソッドを使用してもページに表示されるコンテンツは追加されないため、通常は、C1PdfDocument.AddLink と一緒に別のコマンドを使用して、ユーザーに表示するテキストや画像を指定する必要があります。たとえば、次のコードは、「Visit ComponentOne」という文字列と、ComponentOne のホームページに移動するリンクを追加します。

Visual Basic	コードのコピー
Dim rect As New Rect(50, 50, 100, 15) Dim font As New Font("Arial", 10) pdf.AddLink("https://www.grapecity.co.jp/developer", rect) pdf.DrawString("ComponentOne", font, Windows.UI.Colors.Blue, rect)

C#	コードのコピー
Rect rect = new Rect(50, 50, 100, 15); Font font = new Font("Arial", 10); pdf.AddLink("https://www.grapecity.co.jp/developer", rect); pdf.DrawString("ComponentOne", font, Windows.UI.Colors.Blue, rect);

コードのコピー

Rect rect = new Rect(50, 50, 100, 15);
Font font = new Font("Arial", 10);
pdf.AddLink("https://www.grapecity.co.jp/developer", rect);
pdf.DrawString("ComponentOne", font, Windows.UI.Colors.Blue, rect);

次のような PDF ドキュメントが出力されます。

ローカルリンクも追加できます。ローカルリンクをクリックすると、ユーザーは同じ PDF ドキュメント内の別の場所に移動されます。このタイプのリンクは、目次やインデックスのようなドキュメント内の相互参照を実装する場合に役立ちます。

ローカルリンクは、次の２点を除くと通常のハイパーリンクと同じです。

url パラメータは、"#" から始まる必要があります。
C1PdfDocument.AddTarget メソッドを使用して、リンクのターゲット位置を指定する必要があります。C1PdfDocument.AddTarget メソッドは、C1PdfDocument.AddLink と同じパラメータ（ターゲットの名前を示す文字列と、ユーザーがリンクを選択したときに表示されるページ上の領域を特定する四角形）を受け取ります。