Artículo técnico

Añadir hipervínculos clicables a archivos PDF con HotPDF

· Software PDF

Esta muestra de HotPDF enseña cómo colocar hipervínculos clicables en un documento PDF generado. Los hipervínculos son una función pequeña, pero importan en facturas, informes, fichas de producto, exportaciones de documentación y cualquier PDF que deba conectar al lector con un sitio web, página de pedido, formulario de soporte o manual online.

La idea importante es que el texto visible y el destino clicable son preocupaciones separadas. Un PDF puede mostrar una etiqueta amigable mientras la anotación apunta a una URL completa. En una aplicación real, mantén sincronizadas esas dos piezas para que los usuarios puedan ver adónde los llevará un enlace.

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
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.

Dónde encaja este patrón

Usa hipervínculos PDF para referencias que deban seguir activas después de enviar el documento por correo, archivarlo o descargarlo desde un portal de clientes. Destinos comunes incluyen páginas de producto, manuales online, notas de versión, gestores de incidencias, facturas, páginas de búsqueda de licencias y endpoints de verificación documental.

Colocación y estilo

Los enlaces PDF son anotaciones colocadas sobre un área de la página. Si cambias fuente, posición del texto, escalado o sistema de coordenadas de la página, verifica que el rectángulo clicable siga coincidiendo con el texto que ve el usuario. Un enlace desplazado visualmente unos píxeles puede parecer roto aunque la URL sea correcta.

El color también forma parte de la experiencia de usuario. El texto azul subrayado sigue siendo la convención más clara para un enlace web, pero los informes generados a veces necesitan un estilo más discreto. Si usas un color personalizado, mantén el texto alrededor lo bastante explícito para que el lector entienda que es clicable.

Lista de validación

  • Usa URL HTTPS completas para documentos públicos.
  • Valida las URL proporcionadas por usuarios antes de escribirlas en un PDF.
  • Prueba los enlaces en más de un visor PDF porque el manejo de anotaciones puede diferir entre lectores.
  • Comprueba el área clicable después de cambiar tamaño de página, márgenes, fuentes o escalado.
  • No ocultes acciones importantes del flujo solo detrás del texto del enlace; proporciona contexto alrededor en el cuerpo del PDF.

Nota sobre SEO y distribución de documentos

Cuando los PDF se publican online, las etiquetas de enlace claras ayudan a usuarios y motores de búsqueda a entender la relación entre el documento y el recurso enlazado. Prefiere texto descriptivo como documentación del producto o portal de soporte al cliente en lugar de etiquetas genéricas como haga clic aquí.