AddCaretAnnotation

Anotacije i interaktivne poveznice

Opis

Dodaje caret anotaciju oznake umetanja (PDF /Subtype /Caret) na odabranu stranicu. Caret anotacija vizualni je simbol koji se uobičajeno koristi za označavanje mjesta na stranici na kojem je tekst ili sadržaj umetnut, izostavljen ili na drugi način zahtijeva pažnju recenzenta. Dostupna su dva oblika simbola: obični caret (None) ili oznaka odlomka (Paragraph). Komponente boje i neprozirnost izražavaju se na ljestvici 0–1; Transparency zadaje se na ljestvici 0–100 (0 = potpuno neprozirno, 100 = potpuno prozirno). Biblioteka podiže verziju dokumenta na PDF 1.5 kada se Caret anotacija izvede uz nižu zaključanu minimalnu verziju. Definirano u ISO 32000-1 §12.5.6.11.

Sintaksa

Delphi

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

Parametri

Left — Vodoravna koordinata donjeg lijevog kuta pravokutnika anotacije, u trenutačnim jedinicama.

Top — Okomita koordinata donjeg lijevog kuta pravokutnika anotacije, u trenutačnim jedinicama.

Width — Širina pravokutnika anotacije.

Height — Visina pravokutnika anotacije.

SymbolType — Stil simbola caret:

0 = None (obični caret "^")

1 = Odlomak (pilcrow "¶")

Bilo koja druga vrijednost tretira se kao 0 (None).

ColorRed, ColorGreen, ColorBlue — RGB komponente (0–1) boje caret oznake, upisuju se u /C.

Title — Ime autora upisano u unos /T anotacije. Proslijedite prazni niz da biste ga preskočili.

Contents — Sadržaj skočnog prozora povezanog s anotacijom. Proslijedite prazni niz da biste ga preskočili.

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

Povratna vrijednost

1 ako je uspješno, 0 ako nije odabran nijedan dokument ili anotacija nije mogla biti stvorena

Napomene

Anotacija se ispisuje s /Type /Annot, /Subtype /Caret, /Rect, /Sy (naziv simbola), /C, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret" i /P. Opcionalno polje /RD (pomak caret unutar /Rect) ne ispisuje se; čitači mu prema zadanim postavkama dodjeljuju nule tako da caret zauzima cijeli pravokutnik anotacije.

Da biste nakon stvaranja prebrisali pravokutnik anotacije, boju ili sadržaj, upotrijebite SetAnnotRect, SetAnnotBorderColor i SetAnnotContents.