AddCircleAnnotation

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

Опис

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

Синтаксис

Delphi

Function TPDFlib.AddCircleAnnotation(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 /Circle, /Rect, /C, /IC (коли Filled), /BS, /Border, /CA, /F = 4 (придатна до друку), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Це збігається з тим, що створюють Adobe Acrobat і Foxit для своїх інструментів рецензування еліпсів, тож зовнішні робочі процеси рецензування можуть знаходити, редагувати, коментувати та відповідати на цю анотацію

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