AddInkAnnotation

Opombe in interaktivne povezave

Opis

Doda oznako s tušem (PDF /Subtype /Ink), ki predstavlja eno ali več ročno narisanih potez, prostoročnih oznak ali skic, narisanih na strani. Vnos slovarja /InkList vsebuje polje potez; vsaka poteza je polje izmeničnih koordinat x/y, ki predstavljajo pot, ki jo je kazalna naprava sledila med dogodkoma spuščanja in dviga peresa. Komponente barve in prosojnost so izražene na lestvici 0–1; Transparency je podan na lestvici 0–100 (0 = povsem neprosojno, 100 = povsem prosojno). Ker ta vstopna točka zapisuje ključ prosojnosti /CA za opombo PDF 1.4, knjižnica pred shranjevanjem odklenjene dokumente z nižjo ciljno različico nadgradi na PDF 1.4; zaklenjeni nižji cilji so zavrnjeni s preverjanjem združljivosti. Opredeljeno v ISO 32000-1 §12.5.6.13.

Sintaksa

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametri

InkPaths — Ena ali več potez, kodiranih kot en niz. Poteze so ločene z '|' ali z novo vrstico (CR / LF / CRLF). Znotraj vsake poteze koordinatni pari uporabljajo isto ločilno konvencijo kot AddPolygonAnnotation: izmenične vrednosti x/y, ločene s presledki, vejicami, podpičji ali tabulatorji. Primer: "100 100 110 105 120 110 | 200 200 210 205" opisuje dve ločeni potezi. Vsaka poteza mora vsebovati vsaj dva koordinatna para (štiri številke) in sodo skupno število vrednosti, sicer klic vrne 0.

BorderWidth — Širina poteze tuša v trenutnih enotah.

InkRed, InkGreen, InkBlue — Komponente RGB (0–1) barve tuša, zapisane v /C.

Title — Ime avtorja, zapisano v vnos /T opombe. Za izpust uporabite prazen niz.

Contents — Telo pojavnega okna, povezanega z opombo. Za izpust uporabite prazen niz.

Transparency — Prosojnost izražena kot odstotek prosojnosti (0–100). Knjižnica to pretvori v PDF /CA = 1 - Transparency/100 in vrednost omeji na dovoljen razpon.

Vrnjene vrednosti

1 ob uspehu, 0 če ni izbran noben dokument, če se niz tuša ne razčleni v veljaven seznam potez ali če opombe ni bilo mogoče ustvariti.

Opombe

Pravokotnik /Rect opombe se samodejno izračuna iz skupnega obsega vseh potez in majhnega odmika, sorazmernega s širino obrobe, tako da upodobljene poteze ostanejo znotraj omejitvenega okvirja opombe.

Ta vstopna točka je primerna tako za digitalizirano rokopisno pisanje, zajeto z napravo na dotik / peresom, kot za programsko ustvarjene prostoročne oblike, kot so čečkasti podpisi ali opombe, uvožene iz drugih orodij. Če želite po ustvarjanju prepisati barvo tuša, obrobo, vsebino ali pravokotnik, uporabite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents in SetAnnotRect.