HotPDF ハイパーリンクのサンプル

この HotPDF サンプルは、作成した PDF 文書にクリック可能なハイパーリンクを配置する方法を示します。ハイパーリンクは小さな機能ですが、請求書、レポート、製品シート、ドキュメントエクスポート、そして読者を Web サイト、注文ページ、サポートフォーム、オンラインマニュアルへ戻したいあらゆる PDF で重要です。

重要なのは、表示テキストとクリック先は別の関心事であるという点です。PDF はわかりやすいラベルを表示しながら、注釈を完全な URL へ向けることができます。実際のアプリケーションでは、ユーザーがリンク先を確認できるよう、この 2 つを同期させてください。

unit Main;

interface

uses

Windows, Messages, SysUtils, Classes, Graphics, Controls, StdCtrls, Forms, Dialogs, HPDFDoc;

type

TForm1 = class(TForm)

HotPDF: THotPDF;

HelloWorldButton: TButton;

edtWeb: TEdit;

edtProduct: TEdit;

edtOrder: TEdit;

edtContact: TEdit;

Label1: TLabel;

Label2: TLabel;

Label3: TLabel;

Label4: TLabel;

procedure HelloWorldButtonClick(Sender: TObject);

private

{ Private declarations }

public

{ Public declarations }

end;

var

Form1: TForm1;

implementation

{$R *.dfm}

procedure TForm1.HelloWorldButtonClick(Sender: TObject);

begin

HotPDF.BeginDoc;

HotPDF.CurrentPage.SetFont( 'Microsoft Sans Serif', [], 13 );

HotPDF.CurrentPage.TextOut(20,30,0,'Clickable links:');

HotPDF.CurrentPage.PrintHyperlink(20, 60, 'Company site: ' + edtWeb.Text, edtWeb.Text);

HotPDF.CurrentPage.PrintHyperlink(20, 80, 'Product page: ' + edtProduct.Text, edtProduct.Text);

HotPDF.CurrentPage.SetRGBHyperlinkColor(clRed);

HotPDF.CurrentPage.PrintHyperlink(20, 100, 'Purchase link: ' + edtOrder.Text, edtOrder.Text);

HotPDF.CurrentPage.SetRGBHyperlinkColor(clBlue);

HotPDF.CurrentPage.PrintHyperlink(20, 120, 'Contact form: ' + edtContact.Text, edtContact.Text);

HotPDF.EndDoc;

end;

end.

このパターンが適する場所

文書がメール送信、アーカイブ、顧客ポータルからのダウンロード後も有効であるべき参照には、PDF ハイパーリンクを使います。一般的な対象には、製品ページ、オンラインマニュアル、リリースノート、課題トラッカー、請求書、ライセンス検索ページ、文書検証エンドポイントがあります。

配置とスタイル

PDF リンクはページ領域上に配置される注釈です。フォント、テキスト位置、拡大縮小、ページ座標系を変更した場合は、クリック可能な矩形がユーザーに見えるテキストとまだ一致しているか確認してください。URL 自体が正しくても、リンクが数ピクセルずれて見えると壊れているように感じられます。

色もユーザー体験の一部です。青い下線付きテキストはいまでも Web リンクとして最も明確な慣例ですが、作成レポートではより控えめなスタイルが必要な場合もあります。カスタム色を使う場合は、読者がクリック可能だと理解できるよう周囲の文言を十分に明確にしてください。

検証チェックリスト

公開文書には完全修飾の HTTPS URL を使います。
ユーザー提供 URL は PDF に書き込む前に検証します。
注釈の扱いはリーダーごとに異なる場合があるため、複数の PDF ビューアーでリンクをテストします。
ページサイズ、余白、フォント、拡大縮小を変更した後はクリック可能領域を確認します。
重要なワークフロー操作をリンク文字列だけに隠さず、PDF 本文内に周辺文脈を用意します。

SEO と文書配布の注意

PDF をオンライン公開する場合、明確なリンクラベルは、ユーザーと検索エンジンの両方が文書とリンク先リソースの関係を理解する助けになります。click here のような汎用ラベルではなく、製品ドキュメントやカスタマーサポートポータルのような説明的なテキストを優先してください。