AddSquareAnnotation
Opombe in interaktivne povezave
Opis
Doda pravokotno označevalno opombo (PDF /Subtype /Square) na izbrano stran. Opomba nariše potezan pravokotnik, vrisan v dani omejitveni pravokotnik, in jo je po želji mogoče zapolniti s polno notranjo barvo. Barvne komponente in prosojnost so izražene na lestvici 0–1; Prosojnost je podana na lestvici 0–100 (0 = popolnoma neprosojno, 100 = popolnoma prosojno). Ker ta vstopna točka zapisuje ključ opacitete /CA za opombo PDF 1.4, knjižnica pred shranjevanjem neodklenjene dokumente z nižjo ciljno različico poviša na PDF 1.4; zaklenjeni nižji cilji so zavrnjeni s preverjanjem združljivosti. Določeno v ISO 32000-1 §12.5.6.8.
Sintaksa
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 — Vodoravna koordinata spodnjega levega kota pravokotnika opombe, v trenutnih enotah.
Top — Navpična koordinata spodnjega levega kota pravokotnika opombe, v trenutnih enotah.
Width — Širina pravokotnika opombe.
Height — Višina pravokotnika opombe.
BorderWidth — Širina poteze roba pravokotnika, v trenutnih enotah. Zapiše se tako v podedovano polje /Border kot tudi v slovar sloga roba /BS.
BorderRed, BorderGreen, BorderBlue — Komponente RGB (0–1) barve poteze, zapisane v /C.
Filled — 1 za zapis notranje barve polnila (/IC), 0 za pustitev pravokotnika nepobarvanega.
FillRed, FillGreen, FillBlue — Komponente RGB (0–1) notranje barve polnila. Če je Filled 0, se prezrejo.
Title — Ime avtorja, zapisano v vnos /T opombe. Za preskok posredujte prazen niz.
Contents — Vsebina pojavnega okna, povezanega z opombo. Za preskok posredujte 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 območje.
Vrnjena vrednost
1 ob uspehu, 0 če ni izbranega dokumenta ali opombe ni bilo mogoče ustvariti.
Opombe
Opomba je zapisana z običajnim naborom polj za označevanje: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (ko je Filled), /BS, /Border, /CA, /F = 4 (natisljivo), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. To ustreza temu, kar pri svojih orodjih za pregled pravokotnikov ustvarjata Adobe Acrobat in Foxit, zato lahko zunanji poteki pregleda poiščejo, uredijo, komentirajo in odgovorijo na nastalo opombo.
Za prepis pravokotnika opombe, barve, vsebine ali roba po ustvarjanju uporabite SetAnnotRect, SetAnnotBorderColor, SetAnnotContents in SetAnnotBorderStyle.