AddCaretAnnotation

Annotationer og hotspot-links

Beskrivelse

Føjer en caret-markeringsannotering (PDF /Subtype /Caret) til den valgte side. En caret-annotering er et visuelt symbol, der normalt markerer en placering på siden, hvor tekst eller indhold er blevet indsat, udeladt eller på anden måde kræver en korrekturlæsers opmærksomhed. Der findes to symbolformer: en almindelig caret (None) eller et afsnitstegn (Paragraph). 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 Caret-annotering oprettes under en lavere låst minimumsversion. Defineret i ISO 32000-1 §12.5.6.11

Syntaks

Delphi

Function TPDFlib.AddCaretAnnotation(Left, Top, Width, Height: Double; SymbolType: Integer; ColorRed, ColorGreen, ColorBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametre

Left — Vandret koordinat for anmærkningsrektangel'ets nederste venstre hjørne i aktuelle enheder.

Top — Lodret koordinat for annotation rectangle's nederste venstre hjørne i de aktuelle enheder.

Width — Annoteringsrektanglets bredde

Height — Annotationsrektanglets højde.

SymbolType — symboltype for indsætningsmærke:

0 = Ingen (almindelig indsætningsmarkør "^")

1 = Afsnit (afsnitstegn "¶")

Enhver anden værdi behandles som 0 (Ingen).

ColorRed, ColorGreen, ColorBlue — RGB-komponenter (0–1) for indsætningsmarkørens farve, skrevet til /C.

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

Annoteringen udsendes med /Type /Annot, /Subtype /Caret, /Rect, /Sy (symbolnavnet), /C, /CA, /F = 4 (udskrivbar), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Caret" og /P. Det valgfrie /RD-felt (caret-forskydning i /Rect) udsendes ikke; læsere sætter som standard alle værdier til nul, så caret-tegnet optager hele annotationsrektanglet.

Brug SetAnnotRect, SetAnnotBorderColor og SetAnnotContents til at overskrive annotationens rektangel, farve eller indhold efter oprettelsen