AddCircleAnnotation

Anotacijos ir aktyviosios nuorodos

Aprašas

Prideda elipsės žymėjimo anotaciją (PDF /Subtype /Circle), įbrėžtą nurodytame stačiakampyje. Nepaisant pavadinimo, anotacija yra visa elipsė ir tikru apskritimu vaizduojama tik tada, kai Width sutampa su Height. Anotaciją galima pasirinktinai užpildyti vientisa vidaus spalva. Spalvos komponentai ir neskaidrumas nurodomi 0–1 skalėje; Transparency pateikiama 0–100 skalėje (0 = visiškai nepermatoma, 100 = visiškai skaidri). Kadangi ši įėjimo vieta išveda PDF 1.4 anotacijos /CA neskaidrumo raktą, biblioteka prieš įrašydama pakelia žemesnės versijos neapsaugotus dokumentus iki PDF 1.4; žemesnio lygio užrakinti dokumentai atmetami suderinamumo tikrinimo metu. Apibrėžta ISO 32000-1 §12.5.6.8.

Sintaksė

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;

Parametrai

Left — Aprėžiančio stačiakampio apatinio kairiojo kampo horizontali koordinatė, dabartiniais vienetais.

Top — Aprėžiančio stačiakampio apatinio kairiojo kampo vertikali koordinatė, dabartiniais vienetais.

Width — Aprėžiančio stačiakampio plotis.

Height — Aprėžiančio stačiakampio aukštis.

BorderWidth — Brūkšnio plotis elipsės kraštui, dabartiniais vienetais. Įrašomas ir į /Border senąjį lauką, ir į /BS kraštinės stiliaus žodyną.

BorderRed, BorderGreen, BorderBlue — RGB komponentai (0–1) brūkšnio spalvai, įrašomi į /C.

Filled — 1, jei reikia išvesti vidaus užpildo spalvą (/IC), 0, jei elipsė turi likti neužpildyta.

FillRed, FillGreen, FillBlue — RGB komponentai (0–1) vidaus užpildo spalvai. Nepaisoma, kai Filled yra 0.

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 standartiniu žymėjimo laukų rinkiniu: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (kai Filled), /BS, /Border, /CA, /F = 4 (spausdinama), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse" ir /P. Tai atitinka tai, ką Adobe Acrobat ir Foxit pateikia savo elipsių peržiūros įrankiams, todėl išorinės peržiūros darbo eigos gali rasti, redaguoti, komentuoti ir atsakyti į gautą anotaciją.

Norėdami po sukūrimo pakeisti aprėžiantį stačiakampį, spalvą, turinį ar kraštinę, naudokite SetAnnotRect, SetAnnotBorderColor, SetAnnotContents ir SetAnnotBorderStyle.