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 — координати початкової точки лінії в поточних одиницях

EndLeft, EndTop — координати кінцевої точки лінії в поточних одиницях

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

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

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