Klikbare hyperlinks toevoegen aan PDF-bestanden met HotPDF

Deze HotPDF-sample laat zien hoe u klikbare hyperlinks in een gegenereerd PDF-document plaatst. Hyperlinks zijn een kleine functie, maar ze zijn belangrijk in facturen, rapporten, productsheets, documentatie-exports en elke PDF die de lezer terug moet leiden naar een website, bestelpagina, supportformulier of online handleiding.

Het belangrijke idee is dat zichtbare tekst en klikbaar doel afzonderlijke zaken zijn. Een PDF kan een vriendelijke labeltekst tonen terwijl de annotatie naar een volledige URL wijst. Houd die twee onderdelen in een echte applicatie gesynchroniseerd zodat gebruikers kunnen zien waar een link naartoe gaat.

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.

Waar dit patroon past

Gebruik PDF-hyperlinks voor verwijzingen die actief moeten blijven nadat het document is gemaild, gearchiveerd of uit een klantportaal is gedownload. Veelvoorkomende doelen zijn productpagina's, online handleidingen, release notes, issue trackers, facturen, licentie-opzoekpagina's en documentverificatie-eindpunten.

Plaatsing en stijl

PDF-links zijn annotaties die over een paginagebied worden geplaatst. Als u het font, de tekstpositie, schaal of het paginacoördinatensysteem wijzigt, controleer dan of de klikbare rechthoek nog steeds overeenkomt met de tekst die de gebruiker ziet. Een link die visueel enkele pixels verschuift, kan kapot aanvoelen zelfs wanneer de URL correct is.

Kleur hoort ook bij de gebruikerservaring. Blauwe onderstreepte tekst blijft de duidelijkste conventie voor een weblink, maar gegenereerde rapporten hebben soms een rustiger stijl nodig. Als u een aangepaste kleur gebruikt, maak dan de omliggende tekst expliciet genoeg zodat de lezer begrijpt dat deze klikbaar is.

Validatiechecklist

Gebruik volledig gekwalificeerde HTTPS-URL's voor openbare documenten.
Valideer door gebruikers aangeleverde URL's voordat u ze in een PDF schrijft.
Test links in meer dan één PDF-viewer, omdat annotatieafhandeling per reader kan verschillen.
Controleer het klikbare gebied na wijzigingen in paginagrootte, marges, fonts of schaal.
Verberg belangrijke workflowacties niet alleen achter linktekst; geef context in de PDF-body.

SEO- en documentdistributieopmerking

Wanneer PDF's online worden gepubliceerd, helpen duidelijke linklabels gebruikers en zoekmachines de relatie tussen het document en de gekoppelde bron te begrijpen. Gebruik liever beschrijvende tekst zoals productdocumentatie of klantensupportportaal dan algemene labels zoals klik hier.