AddLineAnnotation

Annotasjoner og hotspot-lenker

Beskrivelse

Legger til en linje markering-annotasjon (PDF /Subtype /Line) mellom to endepunkter på den valgte siden. Hver ende kan bære en ulik linjeslutt-stil (pil, kvadrat, sirkel, rombe, …), og linjens kropp kan tegnes i en vilkårlig RGB-farge med justerbar dekkevne. Sluttdeler med et interiør (ClosedArrow, Square, Circle, Diamond) kan eventuelt fylles. 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.7

Syntaks

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametere

StartLeft, StartTop — Koordinater til linjens startpunkt, i gjeldende enheter

EndLeft, EndTop — Koordinater til linjens sluttpunkt, i gjeldende enheter

BorderWidth — Strekbredde på linjen og dens sluttdeler, i gjeldende enheter

LineRed, LineGreen, LineBlue — RGB-komponenter (0–1) i linjefargen, skrevet inn i /C

StartStyle, EndStyle — Linjeslutt-stiler for henholdsvis start- og sluttpunktet. Bruk en av:

0 = None, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash.

Verdier utenfor gyldig område begrenses til 0 (None)

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

FillRed, FillGreen, FillBlue — RGB-komponenter (0–1) i fyllfargen til sluttdeler. 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

Annotasjonens /Rect beregnes automatisk fra de to endepunktene pluss en utfylling proporsjonal med kantbredden slik at sluttdeler forblir innenfor annotasjonens avgrensende boks. PDF-lesere krever at den avgrensende /Rect-en inneholder hele den synlige tegningen, ellers kan sluttdeler klippes

Valgfrie avanserte felt beskrevet av PDF-spesifikasjonen — /LL (leader lengde), /LLE, /LLO, /Cap, /CP, /CO og /Measure — emiteres ikke av dette inngangspunktet. De kan legges til etter opprettelse ved å skrive dem inn på annotasjonsordboken direkte

For å overskrive linjefarge, kant, innhold eller rektangel etter opprettelsen, bruk SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents og SetAnnotRect