AddLineAnnotation

Anotácie a aktívne odkazy

Opis

Pridáva anotáciu typu line markup (PDF /Subtype /Line) medzi dva koncové body na vybratej stránke. Každý koniec môže mať iný štýl koncovej čiary (arrow, square, circle, diamond, …) a telo čiary možno vykresliť v ľubovoľnej farbe RGB s nastaviteľnou nepriehľadnosťou. Koncové ozdoby s vnútrom (ClosedArrow, Square, Circle, Diamond) možno voliteľne vyplniť. Keďže tento vstupný bod zapisuje kľúč nepriehľadnosti /CA anotácie PDF 1.4, knižnica pred uložením zvýši nižšie neuzamknuté dokumenty na PDF 1.4; uzamknuté ciele s nižšou verziou odmietne kontrola kompatibility. Definované v ISO 32000-1 §12.5.6.7.

Syntax

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;

Parametre

StartLeft, StartTop — Súradnice začiatočného koncového bodu čiary v aktuálnych jednotkách.

EndLeft, EndTop — Súradnice koncového bodu čiary v aktuálnych jednotkách.

BorderWidth — Šírka ťahu čiary a jej koncových ozdôb v aktuálnych jednotkách.

LineRed, LineGreen, LineBlue — RGB zložky (0–1) farby čiary, zapisované do /C.

StartStyle, EndStyle — Štýly koncovej čiary pre začiatočný a koncový bod. Použite jednu z možností:

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

Hodnoty mimo rozsahu sa pripnú na 0 (None).

Filled — 1 na zápis vnútornej výplňovej farby (/IC) pre koncové ozdoby, 0 na ponechanie bez výplne.

FillRed, FillGreen, FillBlue — RGB zložky (0–1) vnútornej výplňovej farby koncových ozdôb. Ignorované, keď je Filled 0.

Title — Meno autora zapísané do položky /T anotácie. Na preskočenie zadajte prázdny reťazec.

Contents — Text obsahu vyskakovacieho okna priradeného k anotácii. Na preskočenie zadajte prázdny reťazec.

Transparency — Nepriehľadnosť vyjadrená ako percento priehľadnosti (0–100). Knižnica ju prevedie na PDF /CA = 1 - Transparency/100 a ohraničí na rozsah.

Návratové hodnoty

1 pri úspechu, 0 ak nie je vybraný dokument alebo sa anotáciu nepodarilo vytvoriť.

Poznámky

Anotácia /Rect sa automaticky vypočíta zo súradníc oboch koncových bodov plus odsadenie úmerné šírke okraja, aby ozdoby na koncoch zostali vo vnútri ohraničovacieho rámca anotácie. Čitatelia PDF vyžadujú, aby ohraničujúci /Rect obsahoval celé viditeľné kreslenie, inak sa koncové ozdoby môžu orezať.

Voliteľné pokročilé polia opísané v špecifikácii PDF — /LL (leader length), /LLE, /LLO, /Cap, /CP, /CO a /Measure — tento vstupný bod nezapisuje. Po vytvorení ich môžete doplniť tak, že ich zapíšete priamo do slovníka anotácie.

Na prepísanie farby čiary, okraja, obsahu alebo obdĺžnika po vytvorení použite SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect.