AddCircleAnnotation

Annotations and hotspot links

Beschrijving

Voegt een ellips markup-annotatie (PDF /Subtype /Circle) toe die in de opgegeven rechthoek past. Ondanks de naam is de annotatie een volledige ellips en rendert hij alleen als echte cirkel wanneer Width gelijk is aan Height. De annotatie kan optioneel worden gevuld met een effen binnenkleur. Kleurcomponenten en dekking worden op een 0–1-schaal uitgedrukt; Transparency loopt van 0–100 (0 = volledig dekkend, 100 = volledig transparant). Omdat dit entrypoint de PDF 1.4-annotatiedekkingssleutel /CA uitgeeft, verhoogt de library lager onvergrendelde documenten naar PDF 1.4 vóór het opslaan; vergrendelde lagere doelen worden door de compatibiliteitspoort geweigerd. Gedefinieerd in ISO 32000-1 §12.5.6.8

Syntaxis

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;

Parameters

Left — Horizontale coördinaat van de linkerbenedenhoek van de omsluitende rechthoek, in de huidige eenheden

Top — Verticale coördinaat van de linkerbenedenhoek van de omsluitende rechthoek, in de huidige eenheden

Width — Breedte van de omsluitende rechthoek

Height — Hoogte van de omsluitende rechthoek

BorderWidth — Lijndikte van de ellipsrand, in de huidige eenheden. Wordt zowel in het verouderde veld /Border als in het /BS border-style-woordenboek weggeschreven

BorderRed, BorderGreen, BorderBlue — RGB-componenten (0–1) van de lijnkleur, weggeschreven naar /C

Filled — 1 om een binnenste vulkleur (/IC) uit te geven, 0 om de ellips ongevuld te laten

FillRed, FillGreen, FillBlue — RGB-componenten (0–1) van de binnenste vulkleur. Wordt genegeerd als Filled 0 is

Title — Auteursnaam die in de /T-entry van de annotatie wordt geschreven. Geef een lege string door om deze over te slaan

Contents — Inhoud van de popup die bij de annotatie hoort. Geef een lege string door om deze over te slaan

Transparency — Dekking, uitgedrukt als percentage transparantie (0–100). De library zet dit om naar PDF /CA = 1 - Transparency/100 en begrenst de waarde tot het geldige bereik

Geretourneerde waarde

1 bij succes, 0 als er geen document is geselecteerd of de annotatie niet kon worden aangemaakt

Remarks

De annotatie wordt uitgegeven met een standaardset markup-velden: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (bij Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Dit komt overeen met wat Adobe Acrobat en Foxit voor hun ellips-reviewtools produceren, zodat externe reviewworkflows de resulterende annotatie kunnen vinden, bewerken, becommentariëren en beantwoorden

Om na het aanmaken de omsluitende rechthoek, kleur, inhoud of rand te overschrijven, gebruik SetAnnotRect, SetAnnotBorderColor, SetAnnotContents en SetAnnotBorderStyle