AddLineAnnotation

Jegyzetek és aktívterület-hivatkozások

Leírás

Két végpont között vonaljelölő jegyzetet (PDF /Subtype /Line) ad a kiválasztott oldalhoz. Mindkét végpont eltérő vonalvégstílust (nyíl, négyzet, kör, rombusz, …) kaphat, és a vonal törzse tetszőleges RGB színnel, állítható átlátszatlansággal rajzolható. A belső területtel rendelkező végdíszítések (ClosedArrow, Square, Circle, Diamond) igény szerint kitölthetők. Mivel ez a belépési pont kiadja a PDF 1.4-es jegyzet /CA átlátszatlansági kulcsát, a könyvtár mentés előtt PDF 1.4 szintre emeli az alacsonyabb, zárolás nélküli dokumentumokat; a zárolt alacsonyabb célokat a kompatibilitási ellenőrzés elutasítja. Az ISO 32000-1 §12.5.6.7 határozza meg

Szintaxis

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éterek

StartLeft, StartTop — A vonal's kezdő végpontjának koordinátái az aktuális egységekben

EndLeft, EndTop — A vonal's végpontjának koordinátái az aktuális egységekben

BorderWidth — A vonal és a végdíszítések körvonalvastagsága, az aktuális mértékegységekben

LineRed, LineGreen, LineBlue — a vonalszín /C bejegyzésbe írt RGB-komponensei (0–1)

StartStyle, EndStyle — Vonalvégstílusok rendre a kezdő és záró végponthoz. Használja az alábbiak egyikét:

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

A tartományon kívüli értékek 0-ra (None) korlátozódnak

Kitöltve — 1 értékkel belső kitöltőszínt (/IC) bocsát ki a végdíszítésekhez, 0 értékkel kitöltetlenül hagyja azokat

FillRed, FillGreen, FillBlue — a végdíszítés belső kitöltőszínének RGB-összetevői (0–1). Figyelmen kívül marad, ha a Filled értéke 0

Cím — A megjegyzés's /T bejegyzésébe írt szerzőnév Üres karakterlánc átadásával kihagyható

Tartalom — A jegyzethez társított felugró ablak törzse Üres karakterlánc átadásával kihagyható

Átlátszóság — Az átlátszatlanság százalékos átlátszóságként kifejezve (0–100). A könyvtár ezt PDF /CA = 1 - Transparency/100 értékre alakítja, és a tartományra korlátozza

Visszatérési érték

Siker esetén 1, ha nincs dokumentum kiválasztva vagy a megjegyzés nem hozható létre, akkor 0

Megjegyzések

Az annotáció /Rect értékét automatikusan a két végpont és a keretszélességgel arányos ráhagyás alapján számítja ki, hogy a végdíszítések az annotáció határolókeretén belül maradjanak. A PDF-olvasók megkövetelik, hogy a határoló /Rect tartalmazza a teljes látható rajzot, különben a végdíszítések levágódhatnak

A PDF-specifikációban leírt opcionális speciális mezőket — /LL (vezetővonal hossza), /LLE, /LLO, /Cap, /CP, /CO és /Measure — ez a belépési pont nem bocsátja ki. Létrehozás után közvetlenül a jegyzetszótárba írással fűzhetők hozzá

A vonalszín, a keret, a tartalom vagy a téglalap létrehozás utáni felülírásához használja a SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents és SetAnnotRect függvényeket