SetOutlineDestinationFull
Оглавление
Описание
Задаёт переход элемента оглавления (закладки) на конкретную позицию с масштабом в процентах
Синтаксис
Delphi
Function TPDFlib.SetOutlineDestinationFull(OutlineID, DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;
ActiveX
Function PDFlib::SetOutlineDestinationFull(OutlineID As Long, 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 DLSetOutlineDestinationFull(int InstanceID, int OutlineID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);
Параметры
| OutlineID | Идентификатор раздела оглавления, возвращаемый функцией NewOutline. Либо получите корректный идентификатор функцией GetOutlineID |
|---|---|
| DestPage | Номер страницы, на которую ведёт этот элемент оглавления Масштаб при открытии перехода оглавления в процентах, допустимые значения от 0 до 6400; используется только при DestType = 1, для остальных должен быть 0 |
| Zoom | |
| 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 и масштабируется ровно настолько, чтобы вся высота ограничивающего прямоугольника поместилась в окно. Горизонтальная позиция, используемая при DestType = 1, 4, 5 и 8 |
| Left | |
| Top | Вертикальная позиция, используемая при DestType = 1, 3, 5 и 7 |
| Right | Горизонтальная позиция правой стороны прямоугольника. Используется при DestType = 5 |
| Bottom | Горизонтальная позиция нижней стороны прямоугольника. Используется при DestType = 5 |
Возвращаемые значения
| 0 | Переход оглавления задать не удалось; обычно это значит, что Zoom или DestType вне диапазона либо OutlineID недопустим |
|---|---|
| 1 | Переход раздела оглавления задан успешно |