AddSquareAnnotation

Annotations et liens de zone réactive

Description

Ajoute à la page sélectionnée une annotation rectangulaire (PDF /Subtype /Square), tracée dans le rectangle englobant fourni et remplissable d’une couleur unie. 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.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;

Paramètres

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

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

Width — largeur du rectangle de l’annotation

Height — hauteur du rectangle de l’annotation

BorderWidth — largeur du contour du rectangle 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 le rectangle 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 standard : /Type /Annot, /Subtype /Square, /Rect, /C, /IC si Filled, /BS, /Border, /CA, /F = 4, /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. Cela correspond aux outils rectangulaires 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, la couleur, le contenu ou la bordure de l’annotation, utilisez SetAnnotRect, SetAnnotBorderColor, SetAnnotContents et SetAnnotBorderStyle