AddSquareAnnotation

Анотации и връзки към активни области

Описание

Добавя правоъгълна маркираща анотация (PDF /Subtype /Square) към избраната страница. Анотацията чертае очертан правоъгълник, вписан в дадения ограждащ правоъгълник, и по желание може да бъде запълнена с плътен вътрешен цвят. Компонентите на цвета и непрозрачността се задават по скала от 0–1; Transparency е по скала от 0–100 (0 = напълно непрозрачно, 100 = напълно прозрачно). Тъй като тази входна точка издава ключа за непрозрачност /CA на PDF 1.4, библиотеката повишава по-ниски отключени документи до PDF 1.4 преди записване; заключени по-ниски цели се отхвърлят от проверката за съвместимост. Дефинирано в ISO 32000-1 §12.5.6.8

Синтаксис

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Параметри

Left — Хоризонталната координата на долния ляв ъгъл на правоъгълника на анотацията, в текущите единици

Top — Вертикалната координата на долния ляв ъгъл на правоъгълника на анотацията, в текущите единици

Width — Ширината на правоъгълника на анотацията

Height — Височината на правоъгълника на анотацията

BorderWidth — Ширината на щриха на рамката на правоъгълника, в текущите единици. Записва се както в наследеното поле /Border, така и в речника /BS за стил на рамката

BorderRed, BorderGreen, BorderBlue — RGB компоненти (0–1) на цвета на щриха, записани в /C

Filled — 1 за изписване на вътрешен цвят на запълване (/IC), 0 за оставяне на правоъгълника незапълнен

FillRed, FillGreen, FillBlue — RGB компоненти (0–1) на вътрешния цвят за запълване. Игнорира се, когато Filled е 0

Title — Името на автора, записано в записа /T на анотацията. Подайте празен низ, за да го пропуснете

Contents — Съдържанието на изскачащия прозорец, свързан с анотацията. Подайте празен низ, за да го пропуснете

Transparency — Непрозрачност, изразена като процент прозрачност (0–100). Библиотеката преобразува това в PDF /CA = 1 - Transparency/100 и ограничава стойността до допустимия диапазон

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

1 при успех, 0 ако не е избран документ или анотацията не може да бъде създадена

Бележки

Анотацията се изписва с набор от стандартни полета за маркиране: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (when Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Това съвпада с това, което Adobe Acrobat и Foxit произвеждат за своите инструменти за преглед на правоъгълници, така че външните работни потоци за преглед могат да откриват, редактират, коментират и отговарят на получената анотация

За да замените правоъгълника на анотацията, цвета, съдържанието или рамката след създаване, използвайте SetAnnotRect, SetAnnotBorderColor, SetAnnotContents и SetAnnotBorderStyle