NewDestination

Анотации и hotspot връзки, Управление на документи

Описание

Създава нов обект destination, който може да се използва с функциите AddLinkToDestination, GetDestPage, GetDestType или GetDestValue

Синтаксис

Delphi

Function TPDFlib.NewDestination(DestPage, Zoom, DestType: Integer; Left, Top, Right, Bottom: Double): Integer;

ActiveX

Function PDFlib::NewDestination(DestPage As Long, Zoom As Long, DestType As Long, Left As Double, Top As Double, Right As Double, Bottom As Double) As Long

DLL

int DLNewDestination(int InstanceID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);

Параметри

DestPageНомерът на страницата, към която сочи този обект destination
ZoomПроцентът на увеличение, който да се използва за обекта destination, валидни стойности от 0 до 6400. Използва се само за DestType = 1, а за другите DestTypes трябва да се зададе 0
DestType1 = "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. Страницата се мащабира точно колкото е нужно, за да побере цялата височина на ограничаващата рамка в прозореца
LeftХоризонталната позиция, използвана от DestType = 1, 4, 5 и 8
TopВертикалната позиция, използвана при DestType = 1, 3, 5 и 7. Хоризонталната позиция на десния край на правоъгълника, използвана при DestType = 5
Right
BottomХоризонталната позиция на долната страна на правоъгълника Използва се от DestType = 5

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

0Параметърът DestPage беше невалиден
Non-zero