SetOutlineRemoteDestination

Зміст

Опис

Задає елементу контуру (закладці) відкриття іншого PDF після клацання

Можна задати номер початкової сторінки та різні значення розмірів/позицій

Примітка: оскільки розмір сторінки цільового документа невідомий, усі позиції задаються в пунктах від лівого нижнього кута сторінки, що відкривається

Синтаксис

Delphi

Function TPDFlib.SetOutlineRemoteDestination(OutlineID: Integer; Const FileName: WideString; OpenPage, Zoom, DestType: Integer; PntLeft, PntTop, PntRight, PntBottom: Double; NewWindow: Integer): Integer;

ActiveX

Function PDFlib::SetOutlineRemoteDestination(OutlineID As Long, FileName As String, OpenPage As Long, Zoom As Long, DestType As Long, PntLeft As Double, PntTop As Double, PntRight As Double, PntBottom As Double, NewWindow As Long) As Long

DLL

int DLSetOutlineRemoteDestination(int InstanceID, int OutlineID, const wchar_t * FileName, int OpenPage, int Zoom, int DestType, double PntLeft, double PntTop, double PntRight, double PntBottom, int NewWindow);

Параметри

OutlineID

Ідентифікатор контуру, який повертає функція NewOutline. Інший варіант — отримати чинний ідентифікатор контуру функцією GetOutlineID

FileName

Ім'я файла PDF-документа, який відкриється після клацання на контурі. Формат специфічний: зворотні скісні риски треба замінити звичайними, а диск, якщо є, вказати як саму літеру між скісними рисками, без двокрапки. Наприклад, файл "c:\my documents\hello.pdf" задається як "/c/my documents/hello.pdf". Чинні й відносні шляхи, зокрема з оператором ".." для виходу на рівень вище

OpenPage

Номер сторінки цільового документа, на яку перейти при відкритті. Перша сторінка має індекс нуль (0)

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, і масштабовано настільки, щоб уся висота обмежувального прямокутника вмістилася у вікно

PntLeft

Горизонтальна позиція; використовується для DestType = 1, 4, 5 та 8. Позиція задається в пунктах від лівого нижнього кута сторінки цільового документа

PntTop

Вертикальна позиція; використовується для DestType = 1, 3, 5 та 7. Позиція задається в пунктах від лівого нижнього кута сторінки цільового документа

PntRight

Горизонтальна позиція правого краю прямокутника; використовується для DestType = 5. Позиція задається в пунктах від лівого нижнього кута сторінки цільового документа

PntBottom

Горизонтальна позиція низу прямокутника; використовується для DestType = 5. Позиція задається в пунктах від лівого нижнього кута сторінки цільового документа

NewWindow

0 = замінити поточний документ цільовим

1 = відкрити цільовий документ у новому вікні, якщо користувач не задав у PDF-переглядачі іншу перевагу

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

0Значення OutlineID було недійсним
1Призначення контуру успішно встановлено double PntBottom, int NewWindow);