AddLineAnnotation

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

Описание

Добавя анотация за линейна маркировка (PDF /Subtype /Line) между две крайни точки на избраната страница. Всеки край може да има различен стил на крайна линия (стрелка, квадрат, кръг, ромб, …), а тялото на линията може да бъде изчертано във всеки RGB цвят с конфигурируема непрозрачност. Крайните украси с вътрешност (ClosedArrow, Square, Circle, Diamond) по избор могат да бъдат запълнени. Тъй като тази входна точка извежда ключа за непрозрачност /CA на анотацията PDF 1.4, библиотеката повишава отключените документи с по-ниска версия до PDF 1.4 преди записване; заключените по-ниски цели се отхвърлят от механизма за проверка на съвместимостта. Дефинирано в ISO 32000-1 §12.5.6.7

Синтаксис

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Параметри

StartLeft, StartTop — Координати на line's начална крайна точка в текущите единици

EndLeft, EndTop — Координати на крайната точка на линията's в текущите единици

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 четците изискват ограничаващият /Rect да съдържа целия видим чертеж, иначе крайните украси могат да бъдат отрязани

Незадължителните разширени полета, описани от спецификацията PDF — /LL (дължина на водача), /LLE, /LLO, /Cap, /CP, /CO и /Measure — не се извеждат от тази входна точка. Те могат да се добавят след създаването чрез директно записване в речника на анотацията

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