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
| Left | Vodorovná souřadnice levého okraje obdélníku aktivní oblasti |
|---|---|
| Top | Svislá souřadnice horního okraje obdélníku aktivní oblasti |
| Width | Šířka obdélníku aktivní oblasti |
| Height | Výška obdélníku aktivní oblasti |
| NamedActionType | Vybere 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 |
| Options | Bitová 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ší