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
DestType1 = "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
Left
TopВертикалната позиция, използвана от DestType = 1, 3, 5 и 7
RightХоризонталната позиция на десния ръб на правоъгълника. Използва се от DestType = 5
BottomХоризонталната позиция на долната страна на правоъгълника. Използва се от DestType = 5

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

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