AddPolygonAnnotation

Annotasjoner og hotspot-lenker

Beskrivelse

Legger til en lukket polygon markering-annotasjon (PDF /Subtype /Polygon) på den valgte siden med oppgitt toppunktliste. Polygonet lukkes implisitt — lesere forbinder siste toppunkt tilbake til det første ved rendering. Formen 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). Biblioteket hever dokumentversjonen til PDF 1.5 når en Polygon-annotasjon emiteres under en lavere minimumsversjonslås. Definert 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;

Parametere

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

BorderWidth — Strekbredde på polygon-konturen, i gjeldende enheter

BorderRed, BorderGreen, BorderBlue — RGB-komponenter (0–1) i konturfargen, skrevet inn i /C

Filled — 1 for å skrive en indre fyllfarge (/IC) for polygon-kroppen, 0 for å la den 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, vertex-strengen ikke kan tolkes, eller annotasjonen ikke kunne opprettes

Merknader

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

Valgfrie avanserte felt beskrevet av PDF-spesifikasjonen — /BE (kanteffekt, inkludert den skyete konturstilen), /IT (intent, inkludert PolygonCloud og PolygonDimension) og /Measure — emiteres ikke av dette inngangspunktet. De kan legges til etter opprettelse ved å skrive dem inn på annotasjonsordboken direkte

For å overskrive konturfargen, kanten, innholdet eller rektangelet etter oppretting, bruk SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents og SetAnnotRect