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 |
| DestType | 1 = "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 |