|
Registra um destino simbólico na name tree /Names /Dests do Catalog (ISO 32000-1 §12.3.2.3). Ações GoTo / GoToR e entradas de outline /Dest podem então referenciar o destino pelo nome em vez de fixar números de página no código, mantendo as cross-references estáveis através de inserção / exclusão / reordenação de páginas.
Sintaxe Delphi:
procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Top, Right, Bottom, Zoom: Single = 0);
Parâmetros
Name é a chave única da name tree (sensível a maiúsculas). PageIndex é de base zero e deve apontar para uma página que já foi criada (BeginDoc cria a página 0; AddPage adiciona a página N).
FitMode selects the destination shape per Table 151:
dfmFit — [page /Fit] (página inteira) dfmFitH — [page /FitH top] (usa Top) dfmFitV — [page /FitV left] (usa Left) dfmFitR — [page /FitR llx lly urx ury] — o HotPDF reordena os parâmetros como Left, Bottom, Right, Top dfmFitB — [page /FitB] (PDF 1.1, ajusta o bounding box) dfmFitBH — [page /FitBH top] (PDF 1.1) dfmFitBV — [page /FitBV left] (PDF 1.1) dfmXYZ — [page /XYZ left top zoom] (zero=herdar)
Compliance
Sem gate PDF/A / PDF/X – auxiliares de navegação são permitidos pela spec em todos os perfis de conformidade. PDF 1.2 no mínimo; promove automaticamente a Version do documento a menos que StrictVersionLock esteja definido.
Exemplo
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.
|