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 и трябва да е 0 за други DestType

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. Страницата се мащабира така, че да се вижда цялата ширина на ограничителното поле на страницата (page's bounding box)

8 = "FitBV" - страницата се позиционира на хоризонталната позиция, зададена от параметъра Left. Страницата се мащабира точно толкова, че да побере цялата височина на ограничителната кутия в прозореца

PntLeft

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

PntTop

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

PntRight

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

PntBottom

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

NewWindow

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

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

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