AddLineAnnotation

Annotationer og hotspot-links

Beskrivelse

Tilføjer en linjemarkeringsannotation (PDF /Subtype /Line) mellem to endepunkter på den valgte side. Hver ende kan have en forskellig endelinjetypografi (pil, kvadrat, cirkel, rombe, …), og linjens krop kan tegnes i enhver RGB-farve med konfigurerbar opacitet. Endedekorationer med et indre (ClosedArrow, Square, Circle, Diamond) kan valgfrit udfyldes. Da dette indgangspunkt udsender PDF 1.4-annotationsnøglen /CA til opacitet, hæver biblioteket ulåste dokumenter med lavere version til PDF 1.4 før lagring; låste mål med lavere version afvises af kompatibilitetskontrollen. Defineret 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;

Parametre

StartLeft, StartTop — Koordinaterne for linjen's startpunkt i de aktuelle enheder.

EndLeft, EndTop — Koordinaterne for linjen's slutpunkt i de aktuelle enheder.

BorderWidth — Stregbredde for linjen og dens endemarkeringer i de aktuelle enheder.

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

StartStyle, EndStyle — Slutlinjetyper for henholdsvis start- og slutpunktet. 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, eller annotationen ikke kunne oprettes.

Bemærkninger

Annoteringens /Rect beregnes automatisk ud fra de to endepunkter plus en udfyldning, der er proportional med kantbredden, så slutdekorationer forbliver inden for annoteringens afgrænsningsboks. PDF-læsere kræver, at den afgrænsende /Rect indeholder hele den synlige tegning, ellers kan slutdekorationer blive beskåret

Valgfrie avancerede felter, der er beskrevet i PDF-specifikationen — /LL (lederlængde), /LLE, /LLO, /Cap, /CP, /CO 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 for at overskrive linjefarven, kanten, indholdet eller rektanglet efter oprettelsen.