|
Registriert ein symbolisches Ziel (Destination) im Namensbaum /Names /Dests des Katalogs (ISO 32000-1 §12.3.2.3). GoTo- / GoToR-Aktionen und /Dest-Einträge von Outlines können das Ziel dann per Namen referenzieren, statt Seitenzahlen fest zu verdrahten, sodass Querverweise beim Einfügen, Löschen oder Umsortieren von Seiten stabil bleiben.
Delphi syntax:
procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Top, Right, Bottom, Zoom: Single = 0);
Parameters
Name ist der eindeutige Schlüssel im Namensbaum (Groß-/Kleinschreibung wird unterschieden). PageIndex ist 0-basiert und muss auf eine bereits erzeugte Seite zeigen (BeginDoc erzeugt Seite 0; AddPage fügt Seite N hinzu).
FitMode selects the destination shape per Table 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)
Compliance
Keine PDF/A- / PDF/X-Sperre – Navigationshilfen sind laut Spezifikation in allen Konformitätsprofilen erlaubt. Mindestens PDF 1.2; hebt die Version des Dokuments automatisch an, sofern nicht StrictVersionLock gesetzt ist.
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.
|