AddLinkToNamedAction
Opombe in interaktivne povezave, Lastnosti strani
Opis
Doda klikljiv pravokotnik aktivne točke na izbrano stran, ki ob aktivaciji sproži poimenovano dejanje PDF. Poimenovana dejanja so ukazi za krmarjenje, ki jih nadzira pregledovalnik, opredeljeni v ISO 32000-1 §12.6.4.11, Table 194. Podprta so štiri standardna imena: NextPage, PrevPage, FirstPage in LastPage. Za razliko od AddLinkToPage ni potrebno izrecno navesti ciljne številke strani — pregledovalnik ukaz razlaga med izvajanjem.
Običajna raba: navigacijski gumbi (Next / Previous / Home / End) v glavi ali nogi strani, kjer je cilj relativen glede na stran, ki jo pregledovalnik trenutno prikazuje.
Za spremembo barve roba aktivne točke uporabite funkcijo SetAnnotBorderColor.
Sintaksa
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);
Parametri
| Left | Vodoravna koordinata levega roba pravokotnika aktivne točke |
|---|---|
| Top | Navpična koordinata zgornjega roba pravokotnika aktivne točke |
| Width | Širina pravokotnika aktivne točke |
| Height | Višina pravokotnika aktivne točke |
| NamedActionType | Izbere poimenovano dejanje, ki se sproži: 0 = NextPage, 1 = PrevPage, 2 = FirstPage, 3 = LastPage. Vrednosti zunaj tega obsega se vrnejo na NextPage, da zapisovalnik vedno izpiše ime /N, skladno s specifikacijo. |
| Options | Bitna maska, ki nadzoruje videz povezave. Bit 0 (vrednost 1): nariše rob okoli pravokotnika aktivne točke. Biti 1–3 izberejo način poudarjanja ob kliku (2 = Invert, 4 = Outline, 8 = Push); kadar ni nastavljen noben bit za poudarjanje, je privzeta vrednost Invert. Enaka konvencija kot AddLinkToWeb / AddLinkToPage. |
Opombe
Opomba je združljiva s PDF/A, ker ni sklicevanja na zunanji vir. Zahtevana je PDF 1.1 ali novejša različica.