AddPolyLineAnnotation

Annotationer og hotspot-links

Beskrivelse

Føjer en åben polylinje-markupanmærkning (PDF /Subtype /PolyLine) til den valgte side med den leverede toppunktsliste. Polylinjen er åben — læsere forbinder ikke det sidste toppunkt tilbage til det første — og kan have forskellige slutlinjetyper ved hvert endepunkt. Slutdekorationer med et indre område (ClosedArrow, Square, Circle, Diamond) kan valgfrit udfyldes. Farvekomponenter og opacitet angives på en skala fra 0–1; Transparency angives på en skala fra 0–100 (0 = helt uigennemsigtig, 100 = helt gennemsigtig). Biblioteket hæver dokumentversionen til PDF 1.5, når en PolyLine-anmærkning udsendes under en lavere minimumsversionslås. Defineret 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;

Parametre

VertexCoords — Toppunktskoordinater som én streng af skiftende x/y-værdier adskilt af mellemrum, kommaer, semikoloner eller tabulatorer. Eksempel: "100 100 200 150 300 100" definerer en V-form. Kræver mindst to par (fire tal) og et lige samlet antal tal; ellers returnerer kaldet 0.

BorderWidth — Stregbredde på polylinjen og dens slutdekorationer i aktuelle enheder.

LineRed, LineGreen, LineBlue — RGB-komponenter (0–1) for linjefarven, skrevet til /C.

StartStyle, EndStyle — Slutlinjetyper for henholdsvis første og sidste toppunkt. Brug en af følgende:

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

Værdier uden for intervallet begrænses til 0 (None)

Filled — 1 for at udsende en indvendig udfyldningsfarve (/IC) til slutdekorationerne, 0 for at lade dem være uden udfyldning.

FillRed, FillGreen, FillBlue — RGB-komponenter (0–1) for den indvendige fyldfarve i endemarkeringen. Ignoreres, når Filled er 0.

Title — Forfatternavn, der skrives til PDF'ens /T-post for annotationen. Angiv en tom streng for at udelade det.

Contents — Brødteksten i den popup, der er knyttet til anmærkningen. Angiv en tom streng for at springe over.

Transparency — Opacitet udtrykt som procent gennemsigtighed (0–100). Biblioteket konverterer dette til PDF /CA = 1 - Transparency/100 og begrænser værdien til intervallet.

Returværdi

1 ved succes, 0 hvis intet dokument er valgt, vertexstrengen ikke kan fortolkes, eller annoteringen ikke kunne oprettes.

Bemærkninger

Annotationens /Rect beregnes automatisk ud fra toppunkternes udstrækning plus en udfyldning, der er proportional med kantbredden, så slutdekorationer forbliver inden for annotationens afgrænsningsboks.

Valgfrie avancerede felter beskrevet i PDF-specifikationen — /IT (formål, herunder PolyLineDimension) og /Measure — udsendes ikke af dette indgangspunkt. De kan tilføjes efter oprettelsen ved at skrive dem direkte til annotationsordbogen.

Brug SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents og SetAnnotRect for at overskrive linjefarven, kanten, indholdet eller rektanglet efter oprettelsen.