AddSquareAnnotation

Annotationer og hotspot-links

Beskrivelse

Tilføjer en rektangulær markeringsannotering (PDF /Subtype /Square) til den valgte side. Annoteringen tegner et omridset rektangel indskrevet i det angivne afgrænsningsrektangel og kan eventuelt udfyldes med en ensartet indvendig farve. Farvekomponenter og opacitet udtrykkes på en skala fra 0–1; Transparency angives på en skala fra 0–100 (0 = helt uigennemsigtig, 100 = helt gennemsigtig). Da dette indgangspunkt udsender PDF 1.4-annotationsnøglen /CA for 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.8.

Syntaks

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: 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.

BorderWidth — Stregbredden på rektanglets kant i de aktuelle enheder. Skrives både til det ældre felt /Border og kanttypografiens /BS-ordbog.

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

Filled — 1 for at udsende en indvendig fyldfarve (/IC), 0 for at lade rektanglet 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, eller annotationen ikke kunne oprettes.

Bemærkninger

Annotationen udsendes med et standardfeltsæt for markering: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (ved Filled), /BS, /Border, /CA, /F = 4 (kan udskrives), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Dette svarer til det, Adobe Acrobat og Foxit opretter med deres værktøjer til rektangelgennemgang, så eksterne gennemgangsarbejdsgange kan finde, redigere, kommentere og besvare den resulterende annotation.

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