SetOutlineDestinationFull

Контури

Описание

Задава дестинацията на елемент от контура (bookmark) към конкретна позиция и процент на увеличение

Синтаксис

Delphi

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

ActiveX

Function PDFlib::SetOutlineDestinationFull(OutlineID As Long, 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 DLSetOutlineDestinationFull(int InstanceID, int OutlineID, int DestPage, int Zoom, int DestType, double Left, double Top, double Right, double Bottom);

Параметри

OutlineID	Идентификаторът на контура, върнат от функцията NewOutline. Като алтернатива използвайте GetOutlineID, за да получите валиден идентификатор на контур
DestPage	Номерът на страницата, към която се свързва този елемент от контура Степента на увеличение, която да се използва при отваряне на дестинацията на контура, валидни стойности от 0 до 6400. Използва се само за DestType = 1, за другите DestType трябва да се зададе 0
Zoom
DestType	1 = "XYZ" - целевата страница се позиционира в точката, зададена от параметрите Left и Top. Параметърът Zoom задава процента на мащабиране. 2 = "Fit" - цялата страница се мащабира, за да се побере в прозореца. Не се използва никой от другите параметри и те трябва да се зададат на нула. 3 = "FitH" - страницата се мащабира така, че да се вижда цялата ѝ ширина. Височината на страницата може да е по-голяма или по-малка от височината на прозореца. Страницата се позиционира на вертикалната позиция, зададена от параметъра Top. 4 = "FitV" - страницата се мащабира така, че да се вижда цялата ѝ височина. Ширината на страницата може да е по-голяма или по-малка от ширината на прозореца. Страницата се позиционира на хоризонталната позиция, зададена от параметъра Left. 5 = "FitR" - страницата се мащабира така, че определен правоъгълник на страницата да се вижда. Параметрите Left, Top, Right и Bottom определят правоъгълната област на страницата. 6 = "FitB" - страницата се мащабира така, че да се вижда нейната's ограждаща кутия. 7 = "FitBH" - страницата се позиционира вертикално на позицията, зададена от параметъра Top. Страницата се мащабира така, че да се вижда цялата ширина на ограждащата кутия на страницата's. 8 = "FitBV" - страницата се позиционира на хоризонталната позиция, зададена от параметъра Left. Страницата се мащабира точно толкова, колкото е нужно, за да се побере цялата височина на ограждащата кутия в прозореца. Хоризонталната позиция, използвана от DestType = 1, 4, 5 и 8
Left
Top	Вертикалната позиция, използвана от DestType = 1, 3, 5 и 7
Right	Хоризонталната позиция на десния ръб на правоъгълника. Използва се от DestType = 5
Bottom	Хоризонталната позиция на долната страна на правоъгълника Използва се от DestType = 5

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

0	Не може да се зададе дестинацията на контура. Това обикновено означава, че параметрите Zoom или DestType са извън допустимия диапазон или че OutlineID е невалиден
1	Дестинацията на контура беше зададена успешно