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 LongDLL
int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);Параметры
| DestPage | Номер страницы, на которую ведёт этот объект перехода |
|---|---|
| Zoom | Масштаб целевого объекта в процентах, допустимые значения от 0 до 6400. Используется только при DestType = 1, для остальных DestType должен быть 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 |