AddPolygonAnnotation

Annotaties en hotspotkoppelingen

Beschrijving

Voegt aan de geselecteerde pagina een gesloten polygonale markupannotatie (PDF /Subtype /Polygon) toe met de opgegeven lijst hoekpunten. De polygoon wordt impliciet gesloten — lezers verbinden het laatste hoekpunt bij rendering weer met het eerste. De vorm kan optioneel worden gevuld met een effen binnenkleur. Kleurcomponenten en dekking worden uitgedrukt op een schaal van 0–1; Transparency wordt opgegeven op een schaal van 0–100 (0 = volledig ondoorzichtig, 100 = volledig transparant). De bibliotheek verhoogt de documentversie naar PDF 1.5 wanneer een Polygon-annotatie onder een lagere minimumversievergrendeling wordt uitgevoerd. Gedefinieerd in ISO 32000-1 §12.5.6.9

Syntaxis

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;

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 100 200 200 100 200" definieert een vierkant. Vereist ten minste twee paren (vier getallen) en een even totaal aantal getallen, anders geeft de aanroep 0 terug

BorderWidth — Lijndikte van de polygonomtrek, in de huidige eenheden

BorderRed, BorderGreen, BorderBlue — RGB-componenten (0–1) van de lijnkleur, weggeschreven naar /C

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

FillRed, FillGreen, FillBlue — RGB-componenten (0–1) van de binnenste vulkleur. 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 kleine opvulling evenredig aan de randbreedte, zodat de omtreklijn binnen de bounding box van de annotatie blijft

Optionele geavanceerde velden uit de PDF-specificatie — /BE (border effect, inclusief de cloudy outline-stijl), /IT (intent, inclusief PolygonCloud en PolygonDimension) 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 omtrekkleur, rand, inhoud of rechthoek te overschrijven, gebruik SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents en SetAnnotRect