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

Title — ім'я автора, яке записується в запис /T анотації. Щоб пропустити, передайте порожній рядок

Contents — вміст спливного вікна, пов'язаного з анотацією. Щоб пропустити, передайте порожній рядок

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

Значення, що повертається

1 в разі успіху, 0 — якщо не вибрано жодного документа, рядок вершин не вдалося розібрати або анотацію не вдалося створити

Примітки

Прямокутник /Rect анотації обчислюється автоматично з охоплення вершин плюс відступ, пропорційний ширині рамки, тож кінцеві прикраси лишаються всередині обмежувального прямокутника анотації

Необов'язкові досвідчені поля зі специфікації PDF — /IT (намір, зокрема PolyLineDimension) та /Measure — ця точка входу не емітує. Їх можна дописати після створення, записавши їх прямо в словник анотації

Щоб перезаписати колір лінії, рамку, вміст чи прямокутник після створення, використовуйте SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents і SetAnnotRect