AddLineAnnotation

Annotaties en hotspotkoppelingen

Beschrijving

Voegt een line-markupannotatie (PDF /Subtype /Line) toe tussen twee eindpunten op de geselecteerde pagina. Elk uiteinde kan een eigen eindlijnstijl hebben (pijl, vierkant, cirkel, ruit, …) en de lijn zelf kan in elke RGB-kleur worden getekend met instelbare opacity. Einddecoraties met een binnenvlak (ClosedArrow, Square, Circle, Diamond) kunnen optioneel worden gevuld. Omdat dit entrypoint de PDF 1.4-annotatiesleutel /CA voor opacity genereert, verhoogt de library ontgrendelde documenten met een lagere versie vóór het opslaan naar PDF 1.4; vergrendelde doelen met een lagere versie worden door de compatibiliteitscontrole geweigerd. Gedefinieerd in ISO 32000-1 §12.5.6.7

Syntaxis

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;

Syntaxis

StartLeft, StartTop — Coördinaten van het beginpunt van de lijn, in de huidige eenheden

EndLeft, EndTop — Coördinaten van het eindepunt van de lijn, in de huidige eenheden

BorderWidth — Lijndikte van de lijn 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 het begin- en het eindeindpunt. 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 of de annotatie niet kon worden aangemaakt

Opmerkingen

De annotatie-/Rect wordt automatisch berekend uit de twee eindpunten plus een opvulling evenredig aan de randbreedte, zodat einddecoraties binnen de bounding box van de annotatie blijven. PDF-readers eisen dat de omsluitende /Rect de volledige zichtbare tekening bevat, anders kunnen einddecoraties worden afgeknipt

Optionele geavanceerde velden uit de PDF-specificatie — /LL (leader length), /LLE, /LLO, /Cap, /CP, /CO 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