Ajouter des liens hypertexte cliquables aux fichiers PDF avec HotPDF

Cet exemple HotPDF montre comment placer des liens hypertexte cliquables dans un document PDF généré. Les liens hypertexte sont une petite fonctionnalité, mais ils comptent dans les factures, rapports, fiches produit, exports de documentation et tout PDF qui doit ramener le lecteur vers un site web, une page de commande, un formulaire de support ou un manuel en ligne.

L’idée importante est que le texte visible et la cible cliquable sont deux sujets distincts. Un PDF peut afficher un libellé convivial tandis que l’annotation pointe vers une URL complète. Dans une vraie application, gardez ces deux éléments synchronisés afin que les utilisateurs voient où le lien les mènera.

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.

Où ce modèle convient

Utilisez les liens PDF pour les références qui doivent rester actives après l’envoi du document par e-mail, son archivage ou son téléchargement depuis un portail client. Les cibles courantes incluent pages produit, manuels en ligne, notes de version, suivis d’incidents, factures, pages de recherche de licence et points de terminaison de vérification documentaire.

Placement et style

Les liens PDF sont des annotations placées sur une zone de page. Si vous modifiez la police, la position du texte, l’échelle ou le système de coordonnées de la page, vérifiez que le rectangle cliquable correspond encore au texte vu par l’utilisateur. Un lien visuellement décalé de quelques pixels peut sembler cassé même si l’URL est correcte.

La couleur fait aussi partie de l’expérience utilisateur. Le texte bleu souligné reste la convention la plus claire pour un lien web, mais les rapports générés nécessitent parfois un style plus discret. Si vous utilisez une couleur personnalisée, gardez le texte environnant assez explicite pour que le lecteur comprenne qu’il est cliquable.

Liste de validation

Utilisez des URL HTTPS pleinement qualifiées pour les documents publics.
Validez les URL fournies par les utilisateurs avant de les écrire dans un PDF.
Testez les liens dans plus d’un lecteur PDF, car la gestion des annotations peut différer selon les lecteurs.
Vérifiez la zone cliquable après modification de la taille de page, des marges, des polices ou de l’échelle.
Ne cachez pas les actions importantes du workflow derrière le seul texte du lien; fournissez un contexte autour dans le corps du PDF.

Note SEO et distribution de documents

Lorsque des PDF sont publiés en ligne, des libellés de liens clairs aident les utilisateurs et les moteurs de recherche à comprendre la relation entre le document et la ressource liée. Préférez un texte descriptif comme documentation produit ou portail de support client plutôt que des libellés génériques comme cliquez ici.