AddSquareAnnotation

Анотації та активні зони-посилання

Опис

Додає анотацію розмітки прямокутника (PDF /Subtype /Square) до вибраної сторінки. Анотація малює прямокутник з обведенням, вписаний у задану межову рамку, і може необов'язково заливатися суцільним внутрішнім кольором. Колірні компоненти та непрозорість виражаються за шкалою 0–1; Transparency задається за шкалою 0–100 (0 = повністю непрозоро, 100 = повністю прозоро). Оскільки ця точка входу виводить ключ непрозорості /CA анотацій PDF 1.4, бібліотека піднімає нижчі незаблоковані документи до PDF 1.4 перед збереженням; нижчі заблоковані цілі відхиляються воротами сумісності. Визначено в ISO 32000-1 §12.5.6.8

Синтаксис

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Параметри

Left — горизонтальна координата лівого нижнього кута прямокутника анотації в поточних одиницях

Top — вертикальна координата лівого нижнього кута прямокутника анотації в поточних одиницях

Width — ширина прямокутника анотації

Height — висота прямокутника анотації

BorderWidth — товщина обведення рамки прямокутника в поточних одиницях. Записується і в застаріле поле /Border, і в словник стилю рамки /BS

BorderRed, BorderGreen, BorderBlue — компоненти RGB (0–1) кольору обведення, що записуються в /C

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 — якщо не вибрано жодного документа або анотацію не вдалося створити

Примітки

Анотація емітується зі стандартним набором полів розмітки: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (коли Filled), /BS, /Border, /CA, /F = 4 (придатна до друку), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Це збігається з тим, що створюють Adobe Acrobat і Foxit для своїх інструментів рецензування прямокутників, тож зовнішні робочі процеси рецензування можуть знаходити, редагувати, коментувати та відповідати на цю анотацію

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