AddPolyLineAnnotation

Annotaties en hotspotkoppelingen

Beschrijving

Voegt een open polylijn markup-annotatie (PDF /Subtype /PolyLine) toe aan de geselecteerde pagina met de opgegeven hoekpuntenlijst. De polylijn is open — readers verbinden het laatste hoekpunt niet terug met het eerste — en kan aan elk uiteinde een andere eindlijnstijl dragen. Einddecoraties met een binnenkant (ClosedArrow, Square, Circle, Diamond) kunnen optioneel worden gevuld. Kleurcomponenten en dekking worden op een 0–1-schaal uitgedrukt; Transparency loopt van 0–100 (0 = volledig dekkend, 100 = volledig transparant). De library verhoogt de documentversie naar PDF 1.5 wanneer een PolyLine-annotatie wordt uitgegeven onder een lagere minimumversielocking. Gedefinieerd in ISO 32000-1 §12.5.6.9

Syntaxis

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;

Syntaxis

VertexCoords — Hoekpuntcoördinaten als één string van afwisselende x/y-waarden, gescheiden door spaties, komma's, puntkomma's of tabs. Voorbeeld: "100 100 200 150 300 100" definieert een V-vorm. Vereist ten minste twee paren (vier getallen) en een even totaal aantal getallen, anders geeft de aanroep 0 terug

BorderWidth — Lijndikte van de polylijn en zijn einddecoraties, in de huidige eenheden

LineRed, LineGreen, LineBlue — RGB-componenten (0–1) van de lijnkleur, weggeschreven naar /C

StartStyle, EndStyle — Eindlijnstijlen voor respectievelijk de eerste en laatste hoekpunten. Gebruik een van:

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

Out-of-range values clamp to 0 (None).

Filled — 1 om een binnenste vulkleur (/IC) voor de einddecoraties uit te geven, 0 om ze ongevuld te laten

FillRed, FillGreen, FillBlue — RGB-componenten (0–1) van de binnenste vulkleur van de einddecoratie. Wordt genegeerd als Filled 0 is

Title — Auteursnaam die in de /T-entry van de annotatie wordt geschreven. Geef een lege string door om deze over te slaan

Contents — Inhoud van de popup die bij de annotatie hoort. Geef een lege string door om deze over te slaan

Transparency — Dekking, uitgedrukt als percentage transparantie (0–100). De library zet dit om naar PDF /CA = 1 - Transparency/100 en begrenst de waarde tot het geldige bereik

Geretourneerde waarde

1 bij succes, 0 als er geen document is geselecteerd, de vertex-string niet te parsen is of de annotatie niet kon worden aangemaakt

Opmerkingen

De annotatie-/Rect wordt automatisch berekend uit de hoekpuntenomvang plus een opvulling evenredig aan de randbreedte, zodat einddecoraties binnen de bounding box van de annotatie blijven

Optionele geavanceerde velden uit de PDF-specificatie — /IT (intent, inclusief PolyLineDimension) en /Measure — worden door dit entrypoint niet uitgegeven. Ze kunnen na het aanmaken worden toegevoegd door ze rechtstreeks op het annotatiewoordenboek weg te schrijven

Om na het aanmaken de lijnkleur, rand, inhoud of rechthoek te overschrijven, gebruik SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents en SetAnnotRect