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

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

0	Параметърът DestPage беше невалиден
Ненулева стойност