AddPolygonAnnotation

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

Описание

Добавя затворена полигонална анотация с маркировка (PDF /Subtype /Polygon) към избраната страница със зададения списък от върхове. Полигонът се затваря автоматично — читателите свързват последния връх обратно към първия при визуализация. Формата може по избор да бъде запълнена с плътен вътрешен цвят. Цветовите компоненти и прозрачността са изразени по скала 0–1; Transparency е дадена по скала 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

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

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

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

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

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

Бележки

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

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

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