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); |