AddPolygonAnnotation

Annotationer og hotspot-links

Beskrivelse

Føjer en lukket polygon-markupannotation (PDF /Subtype /Polygon) til den valgte side med den angivne liste over knudepunkter. Polygonen lukkes automatisk — læsere forbinder det sidste knudepunkt med det første ved gengivelse. Figuren kan valgfrit udfyldes med en ensfarvet indvendig farve. 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 der udsendes en Polygon-annotation under en lavere låst minimumsversion. Defineret i ISO 32000-1 §12.5.6.9

Syntaks

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; 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 100 200 200 100 200" definerer et kvadrat. Kræver mindst to par (fire tal) og et lige samlet antal tal; ellers returnerer kaldet 0.

BorderWidth — Stregbredden for polygonens kontur i de aktuelle enheder.

BorderRed, BorderGreen, BorderBlue — RGB-komponenter (0–1) for konturfarven, skrevet til /C.

Filled — 1 for at udsende en indvendig fyldfarve (/IC) til polygonkroppen, 0 for at lade den være uden fyld.

FillRed, FillGreen, FillBlue — RGB-komponenter (0–1) for den indvendige udfyldningsfarve. 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

Annoteringens /Rect beregnes automatisk ud fra toppunkternes udstrækning plus en lille afstand, der er proportional med kantbredden, så konturstregen forbliver inden for annoteringens afgrænsningsramme.

Valgfrie avancerede felter, der er beskrevet i PDF-specifikationen — /BE (kanteffekt, herunder typen med skyformet kontur), /IT (formål, herunder PolygonCloud og PolygonDimension) og /Measure — udsendes ikke af dette indgangspunkt. De kan tilføjes efter oprettelsen ved at skrive dem direkte i annotationsordbogen.

Brug SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents og SetAnnotRect til at overskrive dispositionens farve, kant, indhold eller rektangel efter oprettelsen.