AddLinkToNamedAction

Anotace a hotspotové odkazy, vlastnosti stránek

Popis

Přidá na vybranou stránku klikatelný hotspot obdélník, který při aktivaci spustí pojmenovanou PDF akci. Pojmenované akce jsou navigační příkazy ovládané prohlížečem, definované v ISO 32000-1 §12.6.4.11, Tabulka 194. Podporovány jsou čtyři standardní názvy: NextPage, PrevPage, FirstPage a LastPage. Na rozdíl od AddLinkToPage není potřeba žádné explicitní číslo cílové stránky — prohlížeč interpretuje příkaz až za běhu

Typické použití: navigační tlačítka (Next / Previous / Home / End) v záhlaví nebo zápatí stránky, kde je cíl relativní ke stránce, kterou prohlížeč právě zobrazuje

Barvu rámečku aktivní oblasti změníte funkcí SetAnnotBorderColor

Syntaxe

Delphi

Function TPDFlib.AddLinkToNamedAction(Left, Top, Width, Height: Double; NamedActionType: Integer; Options: Integer): Integer;

DLL

int DLAddLinkToNamedAction(int InstanceID, double Left, double Top, double Width, double Height, int NamedActionType, int Options);

Parametry

LeftVodorovná souřadnice levého okraje obdélníku aktivní oblasti
TopSvislá souřadnice horního okraje obdélníku aktivní oblasti
WidthŠířka obdélníku aktivní oblasti
HeightVýška obdélníku aktivní oblasti
NamedActionTypeVybere pojmenovanou akci ke spuštění: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Hodnoty mimo tento rozsah spadnou na NextPage, takže zapisovač vždy vypíše spec korektní název /N
OptionsBitová maska řídící vzhled odkazu. Bit 0 (hodnota 1): vykreslí ohraničení kolem obdélníku hotspotu. Bity 1–3 vybírají režim zvýraznění kliknutí (2 = Invert, 4 = Outline, 8 = Push); pokud není nastaven žádný bit zvýraznění, použije se jako výchozí Invert. Stejná konvence jako u AddLinkToWeb / AddLinkToPage

Poznámky

Anotace je kompatibilní s PDF/A, protože neodkazuje na žádný externí zdroj. Vyžaduje PDF 1.1 a novější