AddLinkToHideField

Opombe in hotspot povezave, polja obrazca in AcroForms

Opis

Doda klikljiv pravokotnik hotspota na izbrano stran, ki ob aktivaciji sproži dejanje skrivanja PDF. Dejanje skrivanja preklaplja vidnost enega ali več polj AcroForm, kar omogoča dinamično vedenje prikaži/skrij brez JavaScripta. Dejanje je določeno v ISO 32000-1 §12.6.4.10, Table 196.

Tipična uporaba: povezava “Prikaži podrobnosti” / “Skrij podrobnosti” v postavitvi obrazca ali medsebojno izključujoče se skupine polj, kjer klik ene povezave skrije eno skupino in prikaže drugo (združite dva klica AddLinkToHideField z nasprotnimi vrednostmi HideFlag).

Za spremembo barve roba hotspota uporabite funkcijo SetAnnotBorderColor.

Sintaksa

Delphi

Function TPDFlib.AddLinkToHideField(Left, Top, Width, Height: Double; Const FieldNames: WideString; HideFlag: Integer; Options: Integer): Integer;

DLL

int DLAddLinkToHideField(int InstanceID, double Left, double Top, double Width, double Height, const wchar_t * FieldNames, int HideFlag, int Options);

Parametri

Left	Vodoravna koordinata levega roba pravokotnika hotspota
Top	Navpična koordinata zgornjega roba pravokotnika hotspota
Width	Širina pravokotnika hotspota
Height	Višina pravokotnika hotspota
FieldNames	Eno ali več polno določenih imen polj AcroForm, ločenih z vejicami, podpičji ali prelomi vrstic. Začetni in končni presledki ob vsakem imenu se odstranijo. Eno ime zapiše /T kot besedilni niz; dve ali več imen zapišeta /T kot polje besedilnih nizov.
HideFlag	Izbere smer vidnosti. Vrednost, različna od nič, skrije navedena polja (/H true). Nič jih prikaže (/H false).
Options	Bitna maska, ki nadzoruje videz povezave. Bit 0 (vrednost 1): nariše rob okoli pravokotnika hotspota. Biti 1–3 izberejo način poudarka ob kliku (2 = Invert, 4 = Outline, 8 = Push); kadar ni nastavljen noben bit za poudarek, se privzeto uporabi Invert. Enaka konvencija kot AddLinkToWeb / AddLinkToNamedAction.

Opombe

Opomba je združljiva s PDF/A, ker ni sklican noben zunanji vir. Zahtevan je PDF 1.2 ali novejši.