Adicionar hiperlinks clicáveis a arquivos PDF com HotPDF

Este exemplo do HotPDF mostra como colocar hiperlinks clicáveis em um documento PDF gerado. Hiperlinks são um recurso pequeno, mas importam em faturas, relatórios, folhas de produto, exportações de documentação e qualquer PDF que deve conectar o leitor a um site, página de pedido, formulário de suporte ou manual online.

A ideia importante é que o texto visível e o destino clicável são preocupações separadas. Um PDF pode exibir um rótulo amigável enquanto a anotação aponta para uma URL completa. Em uma aplicação real, mantenha essas duas partes sincronizadas para que os usuários vejam para onde um link os levará.

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.

Onde esse padrão se encaixa

Use hiperlinks PDF para referências que devem permanecer ativas depois que o documento for enviado por e-mail, arquivado ou baixado de um portal de clientes. Destinos comuns incluem páginas de produto, manuais online, notas de versão, issue trackers, faturas, páginas de consulta de licença e endpoints de verificação de documentos.

Posicionamento e estilo

Links PDF são anotações colocadas sobre uma área da página. Se você alterar a fonte, posição do texto, escala ou sistema de coordenadas da página, verifique se o retângulo clicável ainda corresponde ao texto que o usuário vê. Um link deslocado visualmente por alguns pixels pode parecer quebrado mesmo quando a URL está correta.

A cor também faz parte da experiência do usuário. Texto azul sublinhado ainda é a convenção mais clara para um link web, mas relatórios gerados às vezes precisam de um estilo mais discreto. Se usar uma cor personalizada, mantenha o texto ao redor explícito o bastante para que o leitor entenda que é clicável.

Checklist de validação

Use URLs HTTPS totalmente qualificadas em documentos públicos.
Valide URLs fornecidas por usuários antes de gravá-las em um PDF.
Teste links em mais de um visualizador PDF porque o tratamento de anotações pode variar entre leitores.
Confira a área clicável depois de alterar tamanho da página, margens, fontes ou escala.
Não esconda ações importantes do workflow apenas atrás do texto do link; forneça contexto ao redor no corpo do PDF.

Nota sobre SEO e distribuição de documentos

Quando PDFs são publicados online, rótulos de link claros ajudam usuários e mecanismos de busca a entender a relação entre o documento e o recurso vinculado. Prefira texto descritivo como documentação do produto ou portal de suporte ao cliente em vez de rótulos genéricos como clique aqui.