AddInkAnnotation

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

Leírás

Egy vagy több kézzel írt vonást, szabadkézi jelet vagy az oldalon rajzolt vázlatot ábrázoló tintajelölési jegyzetet (PDF /Subtype /Ink) ad hozzá. A /InkList szótárbejegyzés vonások tömbjét tartalmazza; minden vonás a toll lenyomása és felengedése közötti, mutatóeszközzel követett útvonalat leíró, váltakozó x/y koordináták tömbje. A színösszetevők és az átlátszatlanság 0–1 skálán értendők; a Transparency 0–100 skálán szerepel (0 = teljesen átlátszatlan, 100 = teljesen átlátszó). Mivel ez a belépési pont a PDF 1.4-es jegyzet /CA átlátszatlansági kulcsát hozza létre, a könyvtár mentés előtt PDF 1.4-re emeli az alacsonyabb, fel nem oldott dokumentumokat; a rögzített alacsonyabb célokat a kompatibilitási kapu elutasítja. Meghatározása: ISO 32000-1 §12.5.6.13

Szintaxis

Delphi

Function TPDFlib.AddInkAnnotation(Const InkPaths: WideString; BorderWidth: Double; InkRed, InkGreen, InkBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Paraméterek

InkPaths — Egyetlen karakterláncba kódolt egy vagy több vonás. A vonásokat az '|' karakter vagy új sor (CR / LF / CRLF) választja el. Minden vonáson belül a koordinátapárok ugyanazt az elválasztási szabályt követik, mint az AddPolygonAnnotation esetén: a váltakozó x/y értékeket szóköz, vessző, pontosvessző vagy tabulátor választja el. Példa: "100 100 110 105 120 110 | 200 200 210 205" két különálló vonást ír le. Minden vonásnak legalább két koordinátapárt (négy számot) és páros számú értéket kell tartalmaznia, ellenkező esetben a hívás 0 értéket ad vissza

BorderWidth — A tinta körvonalvastagsága az aktuális egységekben

InkRed, InkGreen, InkBlue — a tintaszín RGB összetevői (0–1), a /C bejegyzésbe írva

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, 0, ha nincs kiválasztott dokumentum, a tintakarakterlánc nem elemezhető érvényes vonáslistává, vagy az annotáció nem hozható létre

Megjegyzések

A megjegyzés /Rect értéke automatikusan kiszámításra kerül az összes körvonal együttes kiterjedéséből, valamint a szegélyszélességgel arányos kis ráhagyásból, így a megjelenített körvonalak a megjegyzés befoglaló keretén belül maradnak

Ez a belépési pont egyaránt alkalmas érintő- vagy tolleszközzel rögzített digitalizált kézíráshoz, valamint programozott szabadkézi alakzatokhoz, például firkált aláírásokhoz vagy más eszközökből importált jegyzetekhez. A tintaszín, a szegély, 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