AddCircleAnnotation

Anotace a hotspotové odkazy

Popis

Přidá elipsovou markup anotaci (PDF /Subtype /Circle) vepsanou do zadaného obdélníku. Navzdory názvu jde o celou elipsu a skutečný kruh se vykreslí jen tehdy, když se Width rovná Height. Anotaci lze volitelně vyplnit plnou barvou. Barevné složky a neprůhlednost se vyjadřují v měřítku 0–1; Transparency se udává v měřítku 0–100 (0 = zcela neprůhledné, 100 = zcela průhledné). Protože tento vstupní bod vypisuje klíč neprůhlednosti /CA anotací PDF 1.4, knihovna před uložením zvýší odemčené dokumenty s nižší verzí na PDF 1.4; nižší uzamčené cíle odmítne brána kompatibility. Definováno v ISO 32000-1 §12.5.6.8

Syntaxe

Delphi

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

Parametry

Left — Vodorovná souřadnice levého dolního rohu ohraničujícího obdélníku v aktuálních jednotkách

Top — Svislá souřadnice levého dolního rohu ohraničujícího obdélníku v aktuálních jednotkách

Width — Šířka ohraničujícího obdélníku

Height — Výška ohraničujícího obdélníku

BorderWidth — Šířka tahu okraje elipsy v aktuálních jednotkách. Zapisuje se jak do zastaralého pole /Border, tak do slovníku stylu okraje /BS

BorderRed, BorderGreen, BorderBlue — RGB složky (0–1) barvy tahu, zapsané do /C

Filled — 1 zapíše vnitřní barvu výplně (/IC), 0 ponechá elipsu nevyplněnou

FillRed, FillGreen, FillBlue — RGB složky (0–1) barvy vnitřní výplně. Při Filled = 0 se ignorují

Title — Jméno autora zapsané do položky /T anotace. Chcete-li ho přeskočit, předejte prázdný řetězec

Contents — Tělo vyskakovacího okna přiřazeného k anotaci. Chcete-li ho přeskočit, předejte prázdný řetězec

Transparency — Průhlednost vyjádřená jako procento průhlednosti (0–100). Knihovna ji převede na PDF /CA = 1 - Transparency/100 a omezí na povolený rozsah

Návratová hodnota

1 při úspěchu, 0 není-li vybrán žádný dokument nebo nelze-li anotaci vytvořit

Poznámky

Anotace se vypisuje se standardní sadou markup polí: /Type /Annot, /Subtype /Circle, /Rect, /C, /IC (když je Filled), /BS, /Border, /CA, /F = 4 (printable), /M, /CreationDate, /NM, /T, /Contents, /Subj = "Ellipse", /P. Odpovídá to tomu, co produkují nástroje pro recenzi elips v Adobe Acrobat a Foxit, takže externí revizní workflow umí výslednou anotaci najít, upravit, okomentovat i odpovědět na ni

Chcete-li po vytvoření přepsat ohraničující obdélník, barvu, obsah nebo okraj, použijte SetAnnotRect, SetAnnotBorderColor, SetAnnotContents a SetAnnotBorderStyle