AddPolyLineAnnotation

Annotations et liens de zone réactive

Description

Ajoute à la page sélectionnée une annotation polyligne ouverte (PDF /Subtype /PolyLine) avec la liste de sommets fournie — les lecteurs ne relient pas le dernier sommet au premier — et chaque extrémité peut avoir un style différent. Les décorations fermées peuvent recevoir un remplissage. 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 à PDF 1.5 lorsqu’une annotation PolyLine est émise sous un verrou minimal inférieur. Définition dans ISO 32000-1 §12.5.6.9

Syntaxe

Delphi

Function TPDFlib.AddPolyLineAnnotation(Const VertexCoords: WideString; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; 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 150 300 100" définit un V. Au moins deux paires et un nombre total pair sont requis, sinon l’appel renvoie 0

BorderWidth — Largeur du contour de la polyligne et de ses décorations d'extrémité, dans les unités actuelles

LineRed, LineGreen, LineBlue — Composantes RGB (0–1) de la couleur de ligne, écrites dans /C

StartStyle, EndStyle — Styles de fin de ligne des premier et dernier sommets respectivement Utilisez l'un des suivants :

0 = Aucun, 1 = Square, 2 = Circle, 3 = Diamond, 4 = OpenArrow, 5 = ClosedArrow, 6 = Butt, 7 = ROpenArrow, 8 = RClosedArrow, 9 = Slash

Les valeurs hors limites sont ramenées à 0 (Aucun)

Filled — 1 pour émettre une couleur de remplissage intérieur (/IC) des décorations d'extrémité, 0 pour les laisser sans remplissage

FillRed, FillGreen, FillBlue — composantes RVB (0–1) de la couleur de remplissage intérieure de l'ornement final. 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é depuis l'étendue des sommets avec une marge proportionnelle à la bordure, afin que les ornements restent dans la boîte englobante

Les champs avancés facultatifs décrits par la spécification PDF — /IT (intention, y compris PolyLineDimension) et /Measure — ne sont pas émis par ce point d’entrée. Ils peuvent être ajoutés après la création en les écrivant directement dans le dictionnaire d’annotation

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