AddCircleAnnotation

Annotationer og hotspot-links

Beskrivelse

Tilføjer en ellipseformet markup-anmærkning (PDF /Subtype /Circle), som er indskrevet i det angivne rektangel. På trods af navnet er anmærkningen en fuld ellipse og gengives kun som en ægte cirkel, når Width er lig med Height. Anmærkningen 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). Da dette indgangspunkt udsender opacitetsnøglen /CA for PDF 1.4-anmærkninger, hæver biblioteket ulåste dokumenter med en lavere version til PDF 1.4 før lagring; låste lavere mål afvises af kompatibilitetskontrollen. Defineret i ISO 32000-1 §12.5.6.8.

Syntaks

Delphi

Function TPDFlib.AddCircleAnnotation(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 afgrænsningsrektanglet's nederste venstre hjørne i de aktuelle enheder

Top — Lodret koordinat for PDF'ens afgrænsningsrektangels nederste venstre hjørne i de aktuelle enheder.

Width — Afgrænsningsrektanglets bredde.

Height — Afgrænsningsrektanglets højde

BorderWidth — Stregbredden på ellipsens 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 udfyldningsfarve (/IC), 0 for at lade ellipsen være uden udfyldning.

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

Anmærkningen udsendes med et standardsæt af markup-felter: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (når Filled), /BS, /Border, /CA, /F = 4 (kan udskrives), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Dette svarer til, hvad Adobe Acrobat og Foxit frembringer med deres værktøjer til ellipsegennemgang, så eksterne gennemgangsprocesser kan finde, redigere, kommentere og svare på den resulterende anmærkning.

Hvis du vil overskrive afgrænsningsrektanglet, farven, indholdet eller kanten efter oprettelsen, skal du bruge SetAnnotRect, SetAnnotBorderColor, SetAnnotContents og SetAnnotBorderStyle.