AddPolyLineAnnotation

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

Описание

Добавя отворена анотация за маркиране с начупена линия (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

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

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

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

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

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

Забележки

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

Незадължителните разширени полета, описани от спецификацията на PDF — /IT (предназначение, включително PolyLineDimension) и /Measure — не се извеждат от тази входна точка. След създаването им те могат да бъдат добавени чрез директно записване в речника на анотацията

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