AddCircleAnnotation

Anotácie a hotspot odkazy

Opis

Pridáva elipsovitú markup anotáciu (PDF /Subtype /Circle) vpísanú do daného obdĺžnika. Napriek názvu je anotácia plná elipsa a ako skutočný kruh sa vykreslí iba vtedy, keď sa Width rovná Height. Anotácia môže byť voliteľne vyplnená plnou vnútornou farbou. Zložky farby a priehľadnosť sa vyjadrujú v rozsahu 0–1; Transparency je daná v rozsahu 0–100 (0 = úplne nepriehľadné, 100 = úplne priehľadné). Keďže toto vstupné miesto zapisuje kľúč nepriehľadnosti PDF 1.4 /CA, knižnica zvýši nižšie neuzamknuté dokumenty na PDF 1.4 pred uložením; uzamknuté nižšie ciele sa odmietnu kontrolou kompatibility. Definované v ISO 32000-1 §12.5.6.8.

Syntax

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;

Parametre

Left — Vodorovná súradnica dolného ľavého rohu ohraničujúceho obdĺžnika, v aktuálnych jednotkách.

Top — Zvislá súradnica dolného ľavého rohu ohraničujúceho obdĺžnika, v aktuálnych jednotkách.

Width — Šírka ohraničujúceho obdĺžnika.

Height — Výška ohraničujúceho obdĺžnika.

BorderWidth — Šírka ťahu okraja elipsy, v aktuálnych jednotkách. Zapisuje sa do staršieho poľa /Border aj do slovníka štýlu okraja /BS.

BorderRed, BorderGreen, BorderBlue — RGB zložky (0–1) farby ťahu, zapísané do /C.

Filled — 1 na zápis vnútornej farby výplne (/IC), 0 na ponechanie elipsy nevyplnenej.

FillRed, FillGreen, FillBlue — RGB zložky (0–1) vnútornej farby výplne. Ak je Filled 0, ignorujú sa.

Title — Meno autora zapísané do položky /T anotácie. Ak ho chcete vynechať, odovzdajte prázdny reťazec.

Contents — Telo vyskakovacieho okna priradeného k anotácii. Ak ho chcete vynechať, odovzdajte prázdny reťazec.

Transparency — Priehľadnosť vyjadrená ako percento priehľadnosti (0–100). Knižnica to prevádza na PDF /CA = 1 - Transparency/100 a orezáva do rozsahu.

Návratová hodnota

1 pri úspechu, 0 ak nie je vybraný dokument alebo sa anotáciu nepodarilo vytvoriť.

Poznámky

Anotácia sa zapisuje so štandardnou sadou polí markup: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (keď je Filled), /BS, /Border, /CA, /F = 4 (tlačiteľná), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. To zodpovedá tomu, čo vytvárajú Adobe Acrobat a Foxit pre svoje nástroje na recenziu elips, takže externé recenzné pracovné postupy môžu výslednú anotáciu vyhľadať, upravovať, komentovať a odpovedať na ňu.

Na prepísanie ohraničujúceho obdĺžnika, farby, obsahu alebo okraja po vytvorení použite SetAnnotRect, SetAnnotBorderColor, SetAnnotContents a SetAnnotBorderStyle.