AddLineAnnotation

Anotacije i vruće poveznice

Opis

Dodaje anotaciju za liniju (PDF /Subtype /Line) između dviju krajnjih točaka na odabranoj stranici. Svaki kraj može imati različit stil završne linije (strelica, kvadrat, krug, romb, …) i tijelo linije može se crtati u bilo kojoj RGB boji uz podesivu neprozirnost. Završni ukrasi koji imaju unutrašnjost (ClosedArrow, Square, Circle, Diamond) mogu se po želji ispuniti. Budući da ova ulazna točka emitira ključ neprozirnosti /CA za anotaciju PDF 1.4, biblioteka podiže niže otključane dokumente na PDF 1.4 prije spremanja; zaključane niže ciljne verzije odbacuju se putem provjere kompatibilnosti. Definirano u ISO 32000-1 §12.5.6.7.

Sintaksa

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

StartLeft, StartTop — Koordinate početne točke linije, u trenutačnim jedinicama

EndLeft, EndTop — Koordinate završne točke linije, u trenutačnim jedinicama

BorderWidth — Širina poteza linije i njezinih završnih ukrasa, u trenutačnim jedinicama.

LineRed, LineGreen, LineBlue — RGB komponente (0–1) boje linije, zapisane u /C.

StartStyle, EndStyle — Stilovi završne linije za početnu i završnu krajnju točku. Upotrijebite jedan od:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

Out-of-range values clamp to 0 (None).

Filled — 1 za emitiranje unutarnje boje ispune (/IC) za završne ukrase, 0 da ostanu neispunjeni.

FillRed, FillGreen, FillBlue — RGB komponente (0–1) unutarnje boje ispune završnih ukrasa. Zanemaruju se kada je Filled 0.

Title — Ime autora koje se zapisuje u unos /T anotacije. Za preskakanje proslijedite prazan niz znakova

Contents — Sadržaj skočnog prozora povezanog s anotacijom. Za preskakanje proslijedite prazan niz znakova

Transparency — Prozirnost izražena kao postotak prozirnosti (0–100). Biblioteka to pretvara u PDF /CA = 1 - Transparency/100 i ograničava na dopušteni raspon

Return Value

1 pri uspjehu, 0 ako nije odabran dokument ili anotaciju nije moguće stvoriti

Napomene

Pravokutnik anotacije /Rect automatski se računa iz dviju krajnjih točaka uz dodatni razmak proporcionalan širini obruba kako bi završni ukrasi ostali unutar omeđujućeg okvira anotacije. Čitači PDF-a zahtijevaju da omeđujući /Rect sadrži cijeli vidljivi crtež, inače se završni ukrasi mogu odrezati.

Dodatna napredna polja opisana u PDF specifikaciji — /LL (leader length), /LLE, /LLO, /Cap, /CP, /CO i /Measure — ova ulazna točka ne emitira. Ona se mogu dodati nakon stvaranja izravnim upisivanjem u rječnik anotacije.

Za prepisivanje boje linije, obruba, sadržaja ili pravokutnika nakon stvaranja upotrijebite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents i SetAnnotRect