|
Registra una destinazione simbolica nel name tree /Names /Dests del Catalog (ISO 32000-1 §12.3.2.3). Le azioni GoTo / GoToR e le entry /Dest degli outline possono quindi fare riferimento alla destinazione per nome anziché con numeri di pagina fissi, mantenendo stabili i riferimenti incrociati anche quando le pagine vengono inserite, eliminate o riordinate.
Sintassi Delphi:
procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Inizio, Right, Bottom, Zoom: Single = 0);
Parameters
Name è la chiave univoca del name tree (distingue maiuscole e minuscole). PageIndex è in base 0 e deve puntare a una pagina già creata (BeginDoc crea la pagina 0; AddPage aggiunge la pagina N).
FitMode selects the destination shape per Table 151:
dfmFit — [page /Fit] (whole page)
dfmFitH — [page /FitH top] (uses Inizio)
dfmFitV — [page /FitV left] (uses Left)
dfmFitR — [page /FitR llx lly urx ury] — HotPDF reorders parameters as Left, Bottom, Right, Inizio
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)
Compliance
Nessun gate PDF/A / PDF/X – gli ausili di navigazione sono consentiti dalla specifica in tutti i profili di conformità. Richiede almeno PDF 1.2; incrementa automaticamente la Version del documento, a meno che StrictVersionLock sia impostato.
Example
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('FAQInizio', 2, dfmXYZ, 100, 200, 0, 0, 1.5);
PDF.EndDoc;
Availability
HotPDF v2.119.17.
|