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" - цялата страница се мащабира, за да се побере в прозореца. Нито един от другите параметри не се използва и трябва да се зададе 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 | Дестинацията на контура беше зададена успешно |