|
Enregistre une destination symbolique dans l'arborescence de noms /Names /Dests du Catalog (ISO 32000-1 §12.3.2.3). Les actions GoTo / GoToR et les entrées /Dest des signets peuvent alors référencer la destination par son nom au lieu de coder en dur les numéros de page, ce qui maintient des renvois stables lors de l'insertion, de la suppression ou du réordonnancement des pages
Syntaxe Delphi :
procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Haut, Right, Bottom, Zoom: Single = 0);
Paramètres
Name est la clé unique de l'arborescence de noms (sensible à la casse). PageIndex est basé sur 0 et doit pointer vers une page déjà créée (BeginDoc crée la page 0 ; AddPage ajoute la page N)
FitMode sélectionne la forme de destination selon le tableau 151 :
dfmFit — [page /Fit] (page entière)
dfmFitH — [page /FitH top] (utilise Haut)
dfmFitV — [page /FitV left] (utilise Left)
dfmFitR — [page /FitR llx lly urx ury] — HotPDF réordonne les paramètres en Left, Bottom, Right, Top
dfmFitB — [page /FitB] (PDF 1.1, ajuste au cadre englobant)
dfmFitBH — [page /FitBH top] (PDF 1.1)
dfmFitBV — [page /FitBV left] (PDF 1.1)
dfmXYZ — [page /XYZ left top zoom] (zéro = héritage)
Conformité
Aucun contrôle PDF/A / PDF/X – les aides à la navigation sont autorisées par la spécification dans tous les profils de conformité. PDF 1.2 minimum ; la Version du document est relevée automatiquement, sauf si StrictVersionLock est défini.
Exemple
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;
Disponibilité
HotPDF v2.119.17
|