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 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Това съответства на това, което Adobe Acrobat и Foxit генерират за инструментите си за преглед на елипси, така че външните работни потоци могат да намират, редактират, коментират и отговарят на получената анотация

За да промените ограничителния правоъгълник, цвета, съдържанието или рамката след създаване, използвайте SetAnnotRect, SetAnnotBorderColor, SetAnnotContents и SetAnnotBorderStyle