AddCircleAnnotation

Annotasjoner og hotspot-lenker

Beskrivelse

Legger til en ellipse markering-annotasjon (PDF /Subtype /Circle) innskrevet i det gitte rektangelet. Til tross for navnet er annotasjonen en full ellipse og renderer bare som en ekte sirkel når Width er lik Height. Annotasjonen 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.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;

Parametere

Left — Horisontal koordinat for det avgrensende rektangelets nedre venstre hjørne, i gjeldende enheter

Top — Vertikal koordinat for det avgrensende rektangelets nedre venstre hjørne, i gjeldende enheter

Width — Bredden på det avgrensende rektangelet

Height — Høyden på det avgrensende rektangelet

BorderWidth — Strekbredde på ellipsekanten, 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 ellipsen 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 /Circle, /Rect, /C, /IC (når Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Dette matcher det Adobe Acrobat og Foxit produserer for sine ellipse-gjennomgangsverktøy, så eksterne gjennomgangsarbeidsflyter kan finne, redigere, kommentere på og svare på den resulterende annotasjonen

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