AddCircleAnnotation

Annotations et liens de zone réactive

Description

Ajoute une annotation elliptique (PDF /Subtype /Circle) inscrite dans le rectangle donné. Malgré son nom, elle forme une ellipse complète et ne devient un vrai cercle que lorsque Width égale Height. Un remplissage uni est facultatif. Les composantes de couleur et l’opacité utilisent une échelle de 0–1 ; Transparency utilise une échelle de 0–100 (0 = totalement opaque, 100 = totalement transparent). Comme ce point d’entrée émet la clé d’opacité /CA de PDF 1.4, la bibliothèque élève les documents non verrouillés de version inférieure à PDF 1.4 avant enregistrement ; les cibles inférieures verrouillées sont refusées par le contrôle de compatibilité. Définition dans ISO 32000-1 §12.5.6.8

Syntaxe

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;

Paramètres

Left — Coordonnée horizontale de l'angle inférieur gauche du rectangle englobant, dans les unités actuelles

Top — Coordonnée verticale de l'angle inférieur gauche du rectangle englobant, dans les unités actuelles

Width — largeur du rectangle englobant

Height — hauteur du rectangle englobant

BorderWidth — largeur du contour de l'ellipse dans les unités actuelles, écrite dans l'ancien champ /Border et le dictionnaire de style /BS

BorderRed, BorderGreen, BorderBlue — Composantes RGB (0–1) de la couleur de contour, écrites dans /C

Filled — 1 pour émettre une couleur de remplissage intérieur (/IC), 0 pour laisser l'ellipse sans remplissage

FillRed, FillGreen, FillBlue — composantes RVB (0–1) de la couleur de remplissage intérieure. Ignorées lorsque Filled vaut 0

Title — Nom d'auteur écrit dans l'entrée /T de l'annotation Transmettez une chaîne vide pour l'omettre

Contents — Corps de la fenêtre contextuelle associée à l'annotation Transmettez une chaîne vide pour l'omettre

Transparency — opacité exprimée en pourcentage transparent (0–100). La bibliothèque convertit en PDF /CA = 1 - Transparency/100 et borne la plage

Valeur de retour

1 en cas de réussite, 0 si aucun document n'est sélectionné ou si l'annotation n'a pas pu être créée

Remarques

L’annotation est émise avec les champs de balisage standard : /Type /Annot, /Subtype /Circle, /Rect, /C, /IC si Filled, /BS, /Border, /CA, /F = 4, /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Cela correspond aux outils d’ellipse d’Adobe Acrobat et Foxit, afin que les flux de révision puissent la trouver, modifier, commenter et traiter

Pour remplacer après création le rectangle de délimitation, la couleur, le contenu ou la bordure, utilisez SetAnnotRect, SetAnnotBorderColor, SetAnnotContents et SetAnnotBorderStyle