|
Регистрирует символическую точку назначения в /Names /Dests дереве имён Catalog (ISO 32000-1 §12.3.2.3). Действия GoTo / GoToR и /Dest записи outline могут затем ссылаться на точку назначения по имени вместо жёсткой прошивки номеров страниц, что сохраняет перекрёстные ссылки стабильными при вставке / удалении / переупорядочении страниц.
Синтаксис Delphi:
procedure RegisterNamedDestination(const Name: AnsiString; PageIndex: Integer; FitMode: THPDFDestinationFitMode = dfmFit; Left, Top, Right, Bottom, Zoom: Single = 0);
Параметры
Name — уникальный ключ в дереве имён (с учётом регистра). PageIndex отсчитывается от нуля и должен указывать на уже созданную страницу (BeginDoc создаёт страницу 0; AddPage добавляет страницу N).
FitMode выбирает форму точки назначения согласно Table 151:
dfmFit — [page /Fit] (вся страница)
dfmFitH — [page /FitH top] (использует Top)
dfmFitV — [page /FitV left] (использует Left)
dfmFitR — [page /FitR llx lly urx ury] — HotPDF переупорядочивает параметры как Left, Bottom, Right, Top
dfmFitB — [page /FitB] (PDF 1.1, вписывание bounding box)
dfmFitBH — [page /FitBH top] (PDF 1.1)
dfmFitBV — [page /FitBV left] (PDF 1.1)
dfmXYZ — [page /XYZ left top zoom] (ноль=наследование)
Соответствие стандартам
Без гейтов PDF/A / PDF/X – навигационные средства допускаются спецификацией во всех профилях соответствия. Минимум PDF 1.2; версия документа повышается автоматически, если не установлен StrictVersionLock is set.
Пример
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;
Доступность
HotPDF v2.119.17.
|