THotPDF.RegisterNamedDestination

THotPDF

 

Resumen

Registra un destino simbólico en el árbol de nombres /Names /Dests del Catalog (ISO 32000-1 §12.3.2.3). Las acciones GoTo / GoToR y las entradas /Dest del esquema pueden entonces referenciar el destino por nombre en lugar de fijar números de página, con lo que las referencias cruzadas se mantienen estables al insertar, eliminar o reordenar páginas.

 

Sintaxis Delphi:

procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Top, Right, Bottom, Zoom: Single = 0);

 

Parámetros

Name es la clave única del árbol de nombres (distingue mayúsculas de minúsculas). PageIndex es base 0 y debe apuntar a una página que ya se haya creado (BeginDoc crea la página 0; AddPage añade la página N).

FitMode selecciona la forma del destino según la Tabla 151:

   dfmFit — [page /Fit] (whole page)
   dfmFitH — [page /FitH top] (uses Top)
   dfmFitV — [page /FitV left] (uses Left)
   dfmFitR — [page /FitR llx lly urx ury] — HotPDF reorders parameters as Left, Bottom, Right, Top
   dfmFitB — [page /FitB] (PDF 1.1, fit bounding box)
   dfmFitBH — [page /FitBH top] (PDF 1.1)
   dfmFitBV — [page /FitBV left] (PDF 1.1)
   dfmXYZ — [page /XYZ left top zoom] (zero=inherit)

 

Conformidad

Sin compuerta PDF/A / PDF/X – las ayudas de navegación están permitidas por la especificación en todos los perfiles de conformidad. Mínimo PDF 1.2; eleva automáticamente la Version del documento salvo que StrictVersionLock esté asignado.

 

Ejemplo

PDF := THotPDF.Create(nil);
PDF.FileName := 'manual.pdf';
PDF.BeginDoc;
PDF.AddPage;
PDF.AddPage;
PDF.RegisterNamedDestination('Chapter1', 0, dfmFit);
PDF.RegisterNamedDestination('Chapter2', 1, dfmFitH, 0, 500);
PDF.RegisterNamedDestination('FAQTop', 2, dfmXYZ, 100, 200, 0, 0, 1.5);
PDF.EndDoc;

 

Disponibilidad

HotPDF v2.119.17.