AddPolygonAnnotation

Анотации и връзки към горещи точки

Описание

Добавя анотация за маркиране със затворен многоъгълник (PDF /Subtype /Polygon) към избраната страница с предоставения списък от върхове. Многоъгълникът се затваря неявно — при визуализиране четецът свързва последния връх обратно с първия. Фигурата може по избор да бъде запълнена с плътен вътрешен цвят. Цветовите компоненти и непрозрачността се изразяват в скала 0–1; Прозрачност се задава в скала 0–100 (0 = напълно непрозрачно, 100 = напълно прозрачно). Библиотеката повишава версията на документа до PDF 1.5, когато се извежда анотация Polygon при заключване към по-ниска минимална версия. Дефинирано в ISO 32000-1 §12.5.6.9

Синтаксис

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Параметри

VertexCoords — Координати на върховете като един низ от редуващи се стойности x/y, разделени с интервали, запетаи, точка и запетая или табулации. Пример: "100 100 200 100 200 200 100 200" определя квадрат. Изисква поне две двойки (четири числа) и четен общ брой числа, иначе извикването връща 0

BorderWidth — Ширина на щриха на контура на полигона в текущите единици

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

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

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

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

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

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

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

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

Забележки

Записът /Rect на анотацията се изчислява автоматично от обхвата на върховете плюс малко допълнително отместване, пропорционално на ширината на контура, така че очертанието да остане в рамките на ограждащата кутия на анотацията

Допълнителни разширени полета, описани от PDF спецификацията — /BE (border effect, включително стилът на облачен контур), /IT (intent, включително PolygonCloud и PolygonDimension), и /Measure — не се изписват от тази крайна точка. Те могат да бъдат добавени след създаването, като се запишат директно в речника на анотацията

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