THotPDF.RegisterNamedDestination

THotPDF

 

Overzicht

Registreert een symbolische bestemming in de naamboom /Names /Dests van de catalogus (ISO 32000-1 §12.3.2.3). GoTo / GoToR-acties en outline-/Dest-regels kunnen de bestemming dan op naam aanspreken in plaats van paginanummers hard te coderen, waardoor kruisverwijzingen stabiel blijven bij het invoegen, verwijderen en herordenen van pagina's.

 

Delphi-syntax:

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

 

Parameters

Name is de unieke naamboomsleutel (hoofdlettergevoelig). PageIndex is nulgebaseerd en moet naar een pagina wijzen die al is aangemaakt (BeginDoc maakt pagina 0; AddPage voegt pagina N toe).

FitMode kiest de bestemmingsvorm volgens Table 151:

   dfmFit — [page /Fit] (hele pagina)
   dfmFitH — [page /FitH top] (gebruikt Top)
   dfmFitV — [page /FitV left] (gebruikt Left)
   dfmFitR — [page /FitR llx lly urx ury] — HotPDF herordent de parameters als 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] (nul=overerven)

 

Compliance

Geen PDF/A- / PDF/X-poort – navigatiehulpmiddelen zijn volgens de specificatie toegestaan in alle conformiteitsprofielen. Minimaal PDF 1.2; verhoogt de documentversie automatisch tenzij StrictVersionLock is ingesteld.

 

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('FAQTop', 2, dfmXYZ, 100, 200, 0, 0, 1.5);
PDF.EndDoc;

 

Availability

HotPDF v2.119.17.