AddCircleAnnotation

Adnotări și legături hotspot

Descriere

Adaugă o adnotare markup de tip elipsă (PDF /Subtype /Circle) înscrisă în dreptunghiul dat. În ciuda numelui, adnotarea este o elipsă completă și se randează ca cerc adevărat doar când Width este egal cu Height. Adnotarea poate fi opțional umplută cu o culoare interioară uniformă. Componentele de culoare și opacitatea sunt exprimate pe o scală 0–1; Transparency este dat pe o scală 0–100 (0 = complet opac, 100 = complet transparent). Deoarece acest entry point emite cheia de opacitate a adnotării /CA din PDF 1.4, biblioteca ridică documentele mai mici neblocate la PDF 1.4 înainte de salvare; țintele mai mici blocate sunt respinse de poarta de compatibilitate. Definit în ISO 32000-1 §12.5.6.8

Sintaxă

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;

Parametri

Left — coordonata orizontală a colțului din stânga jos al dreptunghiului de încadrare, în unitățile curente

Top — coordonata verticală a colțului din stânga jos al dreptunghiului de încadrare, în unitățile curente

Width — lățimea dreptunghiului de încadrare

Height — înălțimea dreptunghiului de încadrare

BorderWidth — lățimea conturului chenarului elipsei, în unitățile curente. Scrisă atât în câmpul legacy /Border, cât și în dicționarul de stil al chenarului /BS

BorderRed, BorderGreen, BorderBlue — componentele RGB (0–1) ale culorii de contur, scrise în /C

Filled — 1 pentru a emite o culoare de umplere interioară (/IC), 0 pentru a lăsa elipsa neumplută

FillRed, FillGreen, FillBlue — componentele RGB (0–1) ale culorii de umplere interioare. Ignorate când Filled este 0

Title — numele autorului scris în intrarea /T a adnotării. Treceți un șir gol pentru a omite

Contents — conținutul popup-ului asociat adnotării. Treceți un șir gol pentru a omite

Transparency — opacitate exprimată ca procent de transparență (0–100). Biblioteca îl convertește în PDF /CA = 1 - Transparency/100 și îl limitează la interval

Valoare returnată

1 în caz de succes, 0 dacă niciun document nu este selectat sau adnotarea nu a putut fi creată

Observații

Adnotarea este emisă cu setul standard de câmpuri markup: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (când Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Asta corespunde cu ceea ce produc Adobe Acrobat și Foxit pentru instrumentele lor de revizuire a elipselor, deci fluxurile de revizuire externe pot localiza, edita, comenta și răspunde adnotării rezultate

Pentru a suprascrie dreptunghiul de încadrare, culoarea, conținutul sau chenarul după creare, folosiți SetAnnotRect, SetAnnotBorderColor, SetAnnotContents și SetAnnotBorderStyle