AddSquareAnnotation

Anotácie a aktívne odkazy

Opis

Pridá do vybranej stránky obdĺžnikovú značkovú anotáciu (PDF /Subtype /Square). Anotácia vykreslí orámovaný obdĺžnik vpísaný do zadanej ohraničujúcej oblasti a môže byť voliteľne vyplnená plnou vnútornou farbou. Zložky farby a priehľadnosť sa vyjadrujú na stupnici 0–1; Transparency je na stupnici 0–100 (0 = úplne nepriehľadné, 100 = úplne priehľadné). Keďže tento vstupný bod zapisuje kľúč nepriehľadnosti /CA anotácie PDF 1.4, knižnica pred uložením automaticky povýši nižšie odomknuté dokumenty na PDF 1.4; zamknuté nižšie ciele sú kontrolou kompatibility odmietnuté. Definované v ISO 32000-1 §12.5.6.8.

Syntax

Delphi

Function TPDFlib.AddSquareAnnotation(Left, Top, Width, Height: Double; BorderWidth: Double; BorderRed, BorderGreen, BorderBlue: Double; Filled: Integer; FillRed, FillGreen, FillBlue: Double; Const Title, Contents: WideString; Transparency: Integer): Integer;

Parametre

Left — Horizontálna súradnica ľavého dolného rohu obdĺžnika anotácie v aktuálnych jednotkách.

Top — Vertikálna súradnica ľavého dolného rohu obdĺžnika anotácie v aktuálnych jednotkách.

Width — Šírka obdĺžnika anotácie.

Height — Výška obdĺžnika anotácie.

BorderWidth — Šírka ťahu orámovania obdĺžnika v aktuálnych jednotkách. Zapíše sa do starého poľa /Border aj do slovníka štýlu orámovania /BS.

BorderRed, BorderGreen, BorderBlue — Komponenty RGB (0–1) farby ťahu, zapísané do /C.

Filled — 1 pre zápis vnútornej výplňovej farby (/IC), 0 pre ponechanie obdĺžnika bez výplne.

FillRed, FillGreen, FillBlue — Komponenty RGB (0–1) vnútornej výplňovej farby. Ignorované, ak je Filled 0.

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

Contents — Telo vyskakovacieho okna priradeného k anotácii. Na preskočenie použite prázdny reťazec.

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

Návratová hodnota

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

Poznámky

Anotácia sa zapisuje so štandardnou sadou značkových polí: /Type /Annot, /Subtype /Square, /Rect, /C, /IC (ak Filled), /BS, /Border, /CA, /F = 4 (tlačiteľné), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Rectangle", /P. To zodpovedá tomu, čo pre svoje nástroje na revíziu obdĺžnika vytvárajú Adobe Acrobat a Foxit, takže externé pracovné postupy môžu výslednú anotáciu nájsť, upraviť, okomentovať a odpovedať na ňu.

Ak chcete po vytvorení prepísať obdĺžnik anotácie, farbu, obsah alebo orámovanie, použite SetAnnotRect, SetAnnotBorderColor, SetAnnotContents a SetAnnotBorderStyle.