AddLineAnnotation

Annotations et liens de zone réactive

Description

Ajoute entre deux extrémités de la page sélectionnée une annotation de ligne (PDF /Subtype /Line). Chaque extrémité peut avoir un style différent (flèche, carré, cercle, losange, …) et la ligne peut utiliser toute couleur RGB avec une opacité configurable. Les décorations fermées peuvent recevoir un remplissage. 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.7

Syntaxe

Delphi

Function TPDFlib.AddLineAnnotation(StartLeft, StartTop, EndLeft, EndTop: Double; BorderWidth: Double; LineRed, LineGreen, LineBlue: Double; StartStyle, EndStyle: Integer; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Paramètres

StartLeft, StartTop — Coordonnées de l'extrémité initiale de la ligne, dans les unités actuelles

EndLeft, EndTop — Coordonnées de l'extrémité de la ligne, dans les unités actuelles

BorderWidth — Largeur du contour de la ligne 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 points initial et final 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é ou si l'annotation n'a pas pu être créée

Remarques

Le rectangle /Rect de l’annotation est calculé automatiquement à partir des deux extrémités et d’une marge proportionnelle à la largeur de bordure, afin que les décorations restent dans le cadre. Les lecteurs PDF exigent que /Rect contienne tout le tracé visible, sinon les décorations peuvent être rognées

Les champs avancés facultatifs décrits par la spécification PDF — /LL (longueur de ligne de repère), /LLE, /LLO, /Cap, /CP, /CO et /Measure — ne sont pas émis par ce point d’entrée. Ils peuvent être ajoutés après création 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