AddPolyLineAnnotation

Анотации и интерактивни връзки

Описание

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

Синтаксис

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Параметри

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

BorderWidth — Ширина на линията на полилинията и нейните крайни декорации, в текущите единици

LineRed, LineGreen, LineBlue — RGB компоненти (0–1) на цвета на линията, записвани в /C

StartStyle, EndStyle — Стилове на крайните линии за първия и последния връх съответно. Използвайте един от следните:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Стойностите извън диапазона се ограничават до 0 (None)

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 — /IT (intent, including PolyLineDimension) и /Measure — не се излъчват от тази входна точка. Те могат да бъдат добавени след създаването, като се запишат директно в речника на анотацията

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