AddSquareAnnotation

Annotations and hotspot links

Beschrijving

Voegt een rechthoekige markup-annotatie (PDF /Subtype /Square) toe aan de geselecteerde pagina. De annotatie tekent een omlijnde rechthoek die in de opgegeven omsluitende rechthoek past en 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.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;

Parameters

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

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

Width — Breedte van de annotatierrechthoek

Height — Hoogte van de annotatierrechthoek

BorderWidth — Lijndikte van de rand van de rechthoek, 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 rechthoek 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 /Square, /Rect, /C, /IC (bij Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Dit komt overeen met wat Adobe Acrobat en Foxit voor hun rechthoek-reviewtools produceren, zodat externe reviewworkflows de resulterende annotatie kunnen vinden, bewerken, becommentariëren en beantwoorden

Gebruik SetAnnotRect, SetAnnotBorderColor, SetAnnotContents en SetAnnotBorderStyle om de annotatierechthoek, kleur, inhoud of rand na het aanmaken te overschrijven