SetOutlineRemoteDestination

Контури

Описание

Задава елемента от контура (bookmark) да отваря друг PDF, когато бъде щракнат

Може да бъдат указани номерът на началната страница и различни стойности за оразмеряване и позициониране

Забележка: тъй като размерът на страницата на целевия документ не е известен, всички позиции се задават в points, измерени от долния ляв ъгъл на началната страница

Синтаксис

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 документа, който да се отвори, когато се щракне върху елемента от контура. То трябва да бъде в определен формат. Обратните наклонени черти трябва да се преобразуват във forward slash, а устройството, ако има такова, трябва да се посочи само като буквата на устройството между forward slash без двоеточие. Например файлът "c:\my documents\hello.pdf" трябва да бъде указан като "/c/my documents/hello.pdf". Относителните имена на пътища са валидни, включително пътища, които използват оператора ".." за изкачване нагоре в директорията

OpenPage

Номерът на страницата, към която да се премине, когато целевият документ бъде отворен. Първата страница има индекс нула (0)

Zoom

Степента на увеличение, която да се използва при отваряне на документа, валидни стойности от 0 до 6400. Използва се само за DestType = 1, за другите DestType трябва да се зададе 0

DestType

1 = "XYZ" - целевата страница се позиционира в точката, зададена от параметрите Left и Top. Параметърът Zoom указва процента на увеличение

2 = "Fit" - цялата страница се мащабира, за да се побере в прозореца. Нито един от другите параметри не се използва и трябва да се зададе 0

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

PntLeft

Хоризонталната позиция, използвана от DestType = 1, 4, 5 и 8. Позицията се задава в points, измерени от долния ляв ъгъл на страницата на целевия документ

PntTop

Вертикалната позиция, използвана от DestType = 1, 3, 5 и 7. Позицията се задава в points, измерени от долния ляв ъгъл на страницата на целевия документ

PntRight

Хоризонталната позиция на десния ръб на правоъгълника. Използва се от DestType = 5. Позицията се задава в points, измерени от долния ляв ъгъл на страницата на целевия документ

PntBottom

Хоризонталната позиция на долната страна на правоъгълника. Използва се от DestType = 5. Позицията се задава в points, измерени от долния ляв ъгъл на страницата на целевия документ

NewWindow

0 = Замества текущия документ с целевия документ

1 = Отваря целевия документ в нов прозорец, освен ако потребителят не е посочил различно предпочитание в PDF viewer

Върнати стойности