AddRelativeLinkToFileEx

Аннотации и активные ссылки

Описание

Добавляет на выбранную страницу кликабельный прямоугольник активной области, ведущий по относительному пути на заданную страницу и позицию другого PDF-документа. Цвет границы активной области изменяется функцией SetAnnotBorderColor

Ссылка на целевой документ идёт только по имени файла, поэтому размеры страниц целевого документа неизвестны, и параметры DestLeft, DestTop, DestRight и DestBottom всегда задаются в пунктах от левого нижнего угла MediaBox целевой страницы

Синтаксис

Delphi

Function TPDFlib.AddRelativeLinkToFileEx(Left, Top, Width, Height: Double; Const FileName: WideString; DestPage: Integer; NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight, DestBottom: Double): Integer;

ActiveX

Function PDFlib::AddRelativeLinkToFileEx(Left As Double, Top As Double, Width As Double, Height As Double, FileName As String, DestPage As Long, NewWindow As Long, Options As Long, Zoom As Long, DestType As Long, DestLeft As Double, DestTop As Double, DestRight As Double, DestBottom As Double) As Long

DLL

int DLAddRelativeLinkToFileEx(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FileName, int DestPage, int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Параметры

Left

Горизонтальная координата левого края прямоугольника активной области

Top

Вертикальная координата верхнего края прямоугольника активной области

Width

Ширина прямоугольника активной области

Height

Высота прямоугольника активной области

FileName

Полный абсолютный путь и имя PDF-документа для ссылки; путь будет преобразован в относительный

DestPage

Страница целевого документа, на которую ведёт ссылка

NewWindow

0 = закрыть текущий документ и открыть новый

1 = открыть документ в новом окне

Options

Задаёт вид ссылки:

0 = No border

1 = Draw a border

Масштаб целевого объекта в процентах, допустимые значения от 0 до 6400. Используется только при DestType = 1, для остальных DestType должен быть 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 и масштабируется ровно настолько, чтобы вся высота ограничивающего прямоугольника поместилась в окно

DestLeft

Горизонтальная позиция, используемая при DestType = 1, 4, 5 и 8

DestTop

Вертикальная позиция, используемая при DestType = 1, 3, 5 и 7

DestRight

Горизонтальная позиция правой стороны прямоугольника. Используется при DestType = 5

DestBottom

Горизонтальная позиция нижней стороны прямоугольника. Используется при DestType = 5

int NewWindow, int Options, int Zoom, int DestType, double DestLeft, double DestTop, double DestRight, double DestBottom);

Height: Double; FileName: WideString; DestPage, NewWindow, Options, Zoom, DestType: Integer; DestLeft, DestTop, DestRight,