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

LeftVodoravna koordinata levega roba pravokotnika aktivne točke
TopNavpična koordinata zgornjega roba pravokotnika aktivne točke
WidthŠirina pravokotnika aktivne točke
HeightVišina pravokotnika aktivne točke
NamedActionTypeIzbere 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.
OptionsBitna 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.