AddSquareAnnotation

Annotasjoner og hotspot-lenker

Beskrivelse

Legger til et rektangulært markering-annotasjon (PDF /Subtype /Square) på den valgte siden. Annotasjonen tegner et omrissrektangel innskrevet i det gitte avgrensende rektangelet og kan eventuelt fylles med en heltrukket indre farge. Fargekomponenter og dekkevne uttrykkes på en 0–1-skala; Transparency oppgis på en 0–100-skala (0 = helt ugjennomsiktig, 100 = helt gjennomsiktig). Ettersom dette inngangspunktet emiterer PDF 1.4-annotasjonens /CA-dekkevnenøkkel, hever biblioteket lavere ulåste dokumenter til PDF 1.4 før lagring; låste lavere mål avslås av kompatibilitetsporten. Definert i ISO 32000-1 §12.5.6.8

Syntaks

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;

Parametere

Left — Horisontal koordinat for annotasjonsrektangelets nedre venstre hjørne, i gjeldende enheter

Top — Vertikal koordinat for annotasjonsrektangelets nedre venstre hjørne, i gjeldende enheter

Width — Bredden på annotasjonsrektangelet

Height — Høyden til annotasjonsrektangelet

BorderWidth — Strekbredde på rektangelkanten, i gjeldende enheter. Skrives inn i både det gamle /Border-feltet og /BS-kantstilordboken

BorderRed, BorderGreen, BorderBlue — RGB-komponenter (0–1) i strekfargen, skrevet inn i /C

Filled — 1 for å skrive en indre fyllfarge (/IC), 0 for å la rektangelet stå ufylt

FillRed, FillGreen, FillBlue — RGB-komponenter (0–1) i den indre fyllfargen. Ignoreres når Filled er 0

Title — Forfatterens navn, som skrives inn i annotasjonens /T-oppføring. Send en tom streng for å hoppe over

Contents — Innholdet i popup-vinduet knyttet til annotasjonen. Send en tom streng for å hoppe over

Transparency — Dekkevne oppgitt som prosent gjennomsiktighet (0–100). Biblioteket regner om til PDF /CA = 1 - Transparency/100 og begrenser til gyldig område

Return Value

1 ved suksess, 0 hvis ingen dokument er valgt eller annotasjonen ikke kunne opprettes

Merknader

Annotasjonen emiteres med et standard markering-feltsett: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (når Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Dette matcher det Adobe Acrobat og Foxit produserer for sine rektangel-gjennomgangsverktøy, så eksterne gjennomgangsarbeidsflyter kan finne, redigere, kommentere på og svare på den resulterende annotasjonen

For å overskrive annotasjonsrektangelet, fargen, innholdet eller kanten etter oppretting, bruk SetAnnotRect, SetAnnotBorderColor, SetAnnotContents og SetAnnotBorderStyle