Aggiungere collegamenti ipertestuali cliccabili ai PDF con HotPDF

Questo esempio HotPDF mostra come inserire collegamenti ipertestuali cliccabili in un documento PDF generato. I collegamenti sono una funzione piccola, ma contano in fatture, report, schede prodotto, esportazioni di documentazione e qualsiasi PDF che deve riportare il lettore a un sito web, pagina d’ordine, modulo di supporto o manuale online.

L’idea importante è che testo visibile e destinazione cliccabile sono aspetti separati. Un PDF può mostrare un’etichetta amichevole mentre l’annotazione punta a un URL completo. In un’applicazione reale, mantieni sincronizzate queste due parti così gli utenti possono vedere dove li porterà un link.

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.

Dove si adatta questo schema

Usa hyperlink PDF per riferimenti che devono restare attivi dopo che il documento viene inviato via email, archiviato o scaricato da un portale clienti. Destinazioni comuni includono pagine prodotto, manuali online, note di rilascio, issue tracker, fatture, pagine di ricerca licenze ed endpoint di verifica documenti.

Posizionamento e stile

I link PDF sono annotazioni posizionate sopra un’area della pagina. Se cambi font, posizione del testo, scala o sistema di coordinate della pagina, verifica che il rettangolo cliccabile corrisponda ancora al testo visto dall’utente. Un link spostato visivamente di pochi pixel può sembrare rotto anche quando l’URL è corretto.

Anche il colore fa parte dell’esperienza utente. Il testo blu sottolineato resta la convenzione più chiara per un link web, ma i report generati a volte richiedono uno stile più discreto. Se usi un colore personalizzato, mantieni il testo circostante abbastanza esplicito da far capire al lettore che è cliccabile.

Checklist di validazione

Usa URL HTTPS completamente qualificati per documenti pubblici.
Valida gli URL forniti dagli utenti prima di scriverli in un PDF.
Testa i link in più di un viewer PDF perché la gestione delle annotazioni può differire tra lettori.
Controlla l’area cliccabile dopo modifiche a dimensione pagina, margini, font o scala.
Non nascondere azioni importanti del workflow dietro il solo testo del link; fornisci contesto nel corpo del PDF.

Nota su SEO e distribuzione dei documenti

Quando i PDF vengono pubblicati online, etichette di link chiare aiutano utenti e motori di ricerca a capire la relazione tra documento e risorsa collegata. Preferisci testo descrittivo come documentazione del prodotto o portale di supporto clienti invece di etichette generiche come fai clic qui.