AddPolygonAnnotation

Annotations et liens de zone réactive

Description

Ajoute à la page sélectionnée une annotation de polygone fermé (PDF /Subtype /Polygon) avec la liste de sommets fournie. Le polygone est fermé implicitement — les lecteurs relient le dernier sommet au premier lors du rendu. La forme peut recevoir un remplissage uni 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). La bibliothèque élève la version du document à PDF 1.5 lorsqu’une annotation Polygon est émise sous un verrou de version minimale inférieure. Définition dans ISO 32000-1 §12.5.6.9

Syntaxe

Delphi

Function TPDFlib.AddPolygonAnnotation(Const VertexCoords: WideString; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Paramètres

VertexCoords — Coordonnées des sommets sous forme d’une chaîne alternant x/y, séparées par espaces, virgules, points-virgules ou tabulations. Exemple : "100 100 200 100 200 200 100 200" définit un carré. Au moins deux paires et un nombre total pair sont requis, sinon l’appel renvoie 0

BorderWidth — largeur de trait du contour du polygone, dans les unités actuelles

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) du corps du polygone, 0 pour le laisser 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é, si la chaîne de sommets ne peut pas être analysée ou si l'annotation n'a pas pu être créée

Remarques

Le /Rect de l'annotation est calculé automatiquement depuis l'étendue des sommets avec une petite marge proportionnelle à la bordure afin que le contour reste dans la boîte englobante

Les champs avancés facultatifs décrits par la spécification PDF — /BE (effet de bordure, dont contour nuageux), /IT (intention, dont PolygonCloud et PolygonDimension) et /Measure — ne sont pas émis par ce point d’entrée. Ils peuvent être ajoutés après création directement au dictionnaire d’annotation

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