AddCaretAnnotation

Anotacijos ir aktyviosios nuorodos

Aprašas

Prideda caret anotaciją (PDF /Subtype /Caret) prie pasirinkto puslapio. Caret anotacija yra vizualus simbolis, tradiciškai žymintis puslapio vietą, kur buvo įterptas ar praleistas tekstas arba turinys, arba kur kitais atvejais reikia recenzento dėmesio. Galimos dvi simbolio formos: paprasta caret žymė (None) arba pastraipos ženklas (Paragraph). Spalvos komponentai ir neskaidrumas nurodomi 0–1 skalėje; Transparency pateikiama 0–100 skalėje (0 = visiškai nepermatoma, 100 = visiškai skaidri). Kai Caret anotacija išvedama esant mažesnės minimalios versijos užraktui, biblioteka pakelia dokumento versiją iki PDF 1.5. Apibrėžta ISO 32000-1 §12.5.6.11.

Sintaksė

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametrai

Left — Anotacijos stačiakampio apatinio kairiojo kampo horizontali koordinatė, dabartiniais vienetais.

Top — Anotacijos stačiakampio apatinio kairiojo kampo vertikali koordinatė, dabartiniais vienetais.

Width — Anotacijos stačiakampio plotis.

Height — Anotacijos stačiakampio aukštis.

SymbolType — Caret simbolio stilius:

0 = None (paprasta caret žymė "^")

1 = Paragraph (pastraipos ženklas "¶")

Bet kuri kita reikšmė laikoma 0 (None).

ColorRed, ColorGreen, ColorBlue — RGB komponentai (0–1) caret spalvai, įrašomi į /C.

Title — Autoriaus vardas, įrašomas į anotacijos /T lauką. Pateikite tuščią eilutę, jei norite praleisti.

Contents — Iššokančio lango, susieto su anotacija, turinys. Pateikite tuščią eilutę, jei norite praleisti.

Transparency — Skaidrumo procentas (0–100). Biblioteka tai paverčia /CA = 1 - Transparency/100 ir apriboja iki leistino intervalo.

Grąžinamos reikšmės

Sėkmės atveju 1, kitu atveju 0, jei nepasirinktas dokumentas arba anotacijos nepavyko sukurti.

Pastabos

Anotacija išvedama su /Type /Annot, /Subtype /Caret, /Rect, /Sy (simbolio pavadinimas), /C, /CA, /F = 4 (spausdinama), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret" ir /P. Pasirenkamas /RD laukas (caret poslinkis /Rect viduje) neišvedamas; skaitytuvai pagal numatymą jam priskiria visus nulius, todėl caret užima visą anotacijos stačiakampį.

Norėdami po sukūrimo pakeisti anotacijos stačiakampį, spalvą ar turinį, naudokite SetAnnotRect, SetAnnotBorderColor ir SetAnnotContents.