NewDestination

Анотації та активні зони-посилання, керування документами

Опис

Створює новий об’єкт призначення, який можна використовувати з функціями AddLinkToDestination, GetDestPage, GetDestType або GetDestValue.

Синтаксис

Delphi

Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;

ActiveX

Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long

DLL

int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);

Параметри

DestPageНомер сторінки, на яку веде цей об'єкт призначення
ZoomВідсоток масштабу для об'єкта призначення; чинні значення від 0 до 6400. Використовується лише для DestType = 1, для інших DestTypes має бути 0
DestType1 = "XYZ" — цільову сторінку позиціоновано в точці, яку задають параметри Left і Top. Параметр Zoom визначає відсоток масштабу 2 = "Fit" — уся сторінка масштабується під вікно. Інші параметри не використовуються і мають бути нульовими 3 = "FitH" — сторінка масштабується так, щоб було видно всю її ширину. Висота сторінки може бути більшою або меншою за висоту вікна. Сторінку позиціоновано на вертикальній позиції, яку задає параметр Top 4 = "FitV" — сторінка масштабується так, щоб було видно всю її висоту. Ширина сторінки може бути більшою або меншою за ширину вікна. Сторінку позиціоновано на горизонтальній позиції, яку задає параметр Left 5 = "FitR" — сторінка масштабується так, щоб було видно заданий прямокутник на ній. Параметри Left, Top, Right і Bottom визначають цю прямокутну ділянку сторінки 6 = "FitB" — сторінка масштабується так, щоб було видно її обмежувальний прямокутник 7 = "FitBH" — сторінку позиціоновано вертикально в точці, яку задає параметр Top, і масштабовано так, щоб було видно всю ширину її обмежувального прямокутника 8 = "FitBV" — сторінку позиціоновано на горизонтальній позиції, яку задає параметр Left, і масштабовано настільки, щоб уся висота обмежувального прямокутника вмістилася у вікно
LeftГоризонтальна позиція; використовується для DestType = 1, 4, 5 та 8
TopВертикальна позиція; використовується для DestType = 1, 3, 5 та 7 Горизонтальна позиція правого краю прямокутника; використовується для DestType = 5
Right
BottomГоризонтальна позиція низу прямокутника; використовується для DestType = 5

Повернуті значення

0Параметр DestPage був недійсним Значення DestID
Non-zero