AddSquareAnnotation

Merkinnät ja hotspot-linkit

Kuvaus

Lisää suorakulmaisen markkimerkinnän (PDF /Subtype /Square) valitulle sivulle. Merkintä piirtää viivan reunustaman suorakulmion annettuun rajaus­suorakulmioon, ja sen voi halutessaan täyttää tasaisella sisäisellä värillä. Värikomponentit ja peittävyys ilmoitetaan skaalalla 0–1; Transparency ilmoitetaan skaalalla 0–100 (0 = täysin peittävä, 100 = täysin läpinäkyvä). Koska tämä piste tuottaa PDF 1.4:n merkintäavaimen /CA, kirjasto korottaa vanhemmat lukitsemattomat asiakirjat PDF 1.4:ään ennen tallennusta; lukitut alemmat kohteet hylätään yhteensopivuusportissa. Määritelty standardissa ISO 32000-1 §12.5.6.8

Syntaksi

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;

Parametrit

Left — merkintäsuorakulmion vasemman alakulman vaakakoordinaatti nykyisessä yksikössä

Top — merkintäsuorakulmion vasemman alakulman pystykoordinaatti nykyisessä yksikössä

Width — merkintäsuorakulmion leveys

Height — merkintäsuorakulmion korkeus

BorderWidth — suorakulmion reunuksen viivan leveys nykyisessä yksikössä. Kirjoitetaan sekä vanhaan /Border-kenttään että /BS-reunustyyli­sanakirjaan

BorderRed, BorderGreen, BorderBlue — viivan värin RGB-komponentit (0–1), kirjoitetaan /C-tietueeseen

Filled — 1 tuottaa sisäisen täyttövärin (/IC), 0 jättää suorakulmion täyttämättä

FillRed, FillGreen, FillBlue — sisäisen täyttövärin RGB-komponentit (0–1). Ohitetaan, kun Filled on 0

Title — merkinnän /T-tietueeseen kirjoitettava tekijän nimi. Ohita antamalla tyhjä merkkijono

Contents — merkintään liittyvän ponnahduksen sisältö. Ohita antamalla tyhjä merkkijono

Transparency — läpinäkyvyys prosentteina (0–100). Kirjasto muuntaa arvon muotoon PDF /CA = 1 - Transparency/100 ja rajaa sen sallitulle alueelle

Paluuarvo

1 onnistuessaan, 0 jos asiakirjaa ei ole valittuna tai merkinnän luonti epäonnistui

Huomautukset

Merkintä tuotetaan vakiomarkkikenttien joukolla: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (kun Filled), /BS, /Border, /CA, /F = 4 (tulostettava), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Tämä vastaa sitä, mitä Adobe Acrobat ja Foxit tuottavat suorakulmiotarkistustyökaluissaan, joten ulkoiset tarkistustyönkulut voivat paikallistaa, muokata, kommentoida ja vastata syntyvään merkintään

Merkintäsuorakulmion, värin, sisällön tai reunuksen ylikirjoittamiseen luonnin jälkeen käytä funktioita SetAnnotRect, SetAnnotBorderColor, SetAnnotContents ja SetAnnotBorderStyle