AddLineAnnotation

Anotace a hotspotové odkazy

Popis

Přidá anotaci čárového značení (PDF /Subtype /Line) mezi dva koncové body na vybrané stránce. Každý konec může mít jiný styl zakončení čáry (šipka, čtverec, kruh, kosočtverec, …) a tělo čáry lze vykreslit libovolnou barvou RGB s nastavitelnou neprůhledností. Zakončení s vnitřní plochou (ClosedArrow, Square, Circle, Diamond) lze volitelně vyplnit. Protože tento vstupní bod zapisuje klíč neprůhlednosti anotace PDF 1.4 /CA, knihovna před uložením povýší nižší odemčené dokumenty na PDF 1.4; uzamčené cíle s nižší verzí zamítne kontrola kompatibility. Definováno v ISO 32000-1 §12.5.6.7

Syntaxe

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;

Parametry

StartLeft, StartTop — Souřadnice počátečního bodu čáry v aktuálních jednotkách

EndLeft, EndTop — Souřadnice koncového bodu čáry v aktuálních jednotkách

BorderWidth — Šířka tahu čáry a jejích zakončení, v aktuálních jednotkách

LineRed, LineGreen, LineBlue — RGB složky (0–1) barvy čáry, zapsané do /C

StartStyle, EndStyle — Styly zakončení pro počáteční a koncový bod. Použijte jedno z:

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

Out-of-range values clamp to 0 (None).

Filled — 1 vypíše barvu vnitřní výplně (/IC) pro koncovou výzdobu, 0 ji nechá nevyplněnou

FillRed, FillGreen, FillBlue — RGB složky (0–1) barvy vnitřní výplně koncové výzdoby. 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

Obdélník anotace /Rect se spočítá automaticky z obou koncových bodů plus odsazení úměrného šířce okraje, takže zakončení zůstanou uvnitř ohraničujícího boxu anotace. PDF čtečky vyžadují, aby ohraničující /Rect obsahoval celé viditelné kreslení, jinak se zakončení můžou oříznout

Pokročilé volitelné pole popsané specifikací PDF — /LL (délka ukazovátka leader), /LLE, /LLO, /Cap, /CP, /CO a /Measure — tento vstupní bod nevypisuje. Po vytvoření je lze doplnit přímým zápisem do slovníku anotace

Barvu čáry, rámeček, obsah nebo obdélník lze po vytvoření přepsat funkcemi SetAnnotBorderColor, SetAnnotBorderStyle, SetAnnotContents a SetAnnotRect