|
Registra un destino simbólico en el árbol de nombres /Names /Dests del Catálogo (ISO 32000-1 §12.3.2.3). Las acciones GoTo / GoToR y las entradas /Dest del esquema pueden referenciar luego el destino por nombre en lugar de codificar números de página, lo que mantiene estables las referencias cruzadas frente a inserciones, eliminaciones o reordenamientos de páginas
Sintaxis Delphi:
procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Arriba, Right, Bottom, Zoom: Single = 0);
Parámetros
Name es la clave única del árbol de nombres (distingue mayúsculas y minúsculas). PageIndex empieza en 0 y debe apuntar a una página que ya se haya creado (BeginDoc crea la página 0; AddPage agrega la página N)
FitMode selecciona la forma del destino según la Tabla 151:
dfmFit — [page /Fit] (página completa)
dfmFitH — [page /FitH top] (usa Arriba)
dfmFitV — [page /FitV left] (usa Left)
dfmFitR — [page /FitR llx lly urx ury] — HotPDF reordena los parámetros como Left, Bottom, Right, Top
dfmFitB — [page /FitB] (PDF 1.1, ajusta al recuadro de límites)
dfmFitBH — [page /FitBH top] (PDF 1.1)
dfmFitBV — [page /FitBV left] (PDF 1.1)
dfmXYZ — [page /XYZ left top zoom] (cero=hereda)
Compliance
No hay restricción de PDF/A / PDF/X – las ayudas de navegación están permitidas por la especificación en todos los perfiles de conformidad. PDF 1.2 como mínimo; incrementa automáticamente la Version del documento a menos que se establezca StrictVersionLock
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;
Availability
HotPDF v2.119.17
|