AddPolyLineAnnotation

Annotasjoner og hotspot-lenker

Beskrivelse

Legger til en åpen polylinje markering-annotasjon (PDF /Subtype /PolyLine) på den valgte siden med oppgitt toppunktliste. Polylinjen er åpen — lesere forbinder ikke siste toppunkt tilbake til det første — og kan bære ulike linjeslutt-stiler ved hvert endepunkt. Sluttdeler med et interiør (ClosedArrow, Square, Circle, Diamond) kan eventuelt fylles. Fargekomponenter og dekkevne uttrykkes på en 0–1-skala; Transparency oppgis på en 0–100-skala (0 = helt ugjennomsiktig, 100 = helt gjennomsiktig). Biblioteket hever dokumentversjonen til PDF 1.5 når en PolyLine-annotasjon emiteres under en lavere minimumsversjonslås. Definert i ISO 32000-1 §12.5.6.9

Syntaks

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametere

VertexCoords — Hjørnekoordinater som én enkelt streng av vekslende x/y-verdier atskilt med mellomrom, komma, semikolon eller tab. Eksempel: "100 100 200 150 300 100" definerer en V-form. Krever minst to par (fire tall) og et partall totalantall tall, ellers returnerer kallet 0

BorderWidth — Strekbredde på polylinjen 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 første og siste toppunkt. 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, vertex-strengen ikke kan tolkes, eller annotasjonen ikke kunne opprettes

Merknader

Annotasjonens /Rect beregnes automatisk fra toppunkt-utstrekningen pluss en utfylling proporsjonal med kantbredden slik at sluttdeler forblir innenfor annotasjonens avgrensende boks

Valgfrie avanserte felt beskrevet av PDF-spesifikasjonen — /IT (intent, inkludert PolyLineDimension) 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