AddCircleAnnotation

Annotations and hotspot links

Описание

Adds an ellipse markup annotation (PDF /Subtype /Circle) inscribed in the given rectangle. Despite the name, the annotation is a full ellipse and only renders as a true circle when Width equals Height. The annotation can optionally be filled with a solid interior color. Color components and opacity are expressed on a 0–1 scale; Transparency is given on a 0–100 scale (0 = fully opaque, 100 = fully transparent). Because this entry point emits the PDF 1.4 annotation /CA opacity key, the library raises lower unlocked documents to PDF 1.4 before saving; locked lower targets are rejected by the compatibility gate. Defined in 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). Библиотека пересчитывает её в /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, поэтому внешние процессы рецензирования смогут находить, править, комментировать полученную аннотацию и отвечать на неё

To overwrite the bounding rectangle, color, contents, or border after creation, use SetAnnotRect, SetAnnotBorderColor, SetAnnotContents, and SetAnnotBorderStyle.