AddSquareAnnotation

Adnotări și legături hotspot

Descriere

Adaugă o adnotare markup dreptunghiulară (PDF /Subtype /Square) pe pagina selectată. Adnotarea desenează un dreptunghi conturat înscris în dreptunghiul de încadrare dat și 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.AddSquareAnnotation(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 adnotării, în unitățile curente

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

Width — lățimea dreptunghiului adnotării

Height — înălțimea dreptunghiului adnotării

BorderWidth — lățimea conturului chenarului dreptunghiului, î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 dreptunghiul 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 /Square, /Rect, /C, /IC (când Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Asta corespunde cu ceea ce produc Adobe Acrobat și Foxit pentru instrumentele lor de revizuire a dreptunghiurilor, deci fluxurile de revizuire externe pot localiza, edita, comenta și răspunde adnotării rezultate

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