AddLinkToHideField

Anotace a hotspotové odkazy, formulářová pole a AcroForms

Popis

Přidává na vybranou stránku klikatelný obdélník hotspotu, který při aktivaci spustí akci PDF hide. Akce hide přepíná viditelnost jednoho nebo více polí AcroForm a umožňuje tak dynamické chování zobrazit/skrýt bez JavaScriptu. Akce je definována v ISO 32000-1 §12.6.4.10, Table 196

Typické použití: odkaz “Show details” / “Hide details” v rozvržení formuláře, nebo vzájemně se vylučující skupiny polí, kde kliknutí na jeden odkaz skryje jednu skupinu a ukáže jinou (zkombinujte dvě volání AddLinkToHideField s opačnými hodnotami HideFlag)

Použijte funkci SetAnnotBorderColor ke změně barvy ohraničení hotspotu

Syntaxe

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);

Parametry

Left	Vodorovná souřadnice levé hrany hotspotového obdélníku
Top	Svislá souřadnice horní hrany hotspotového obdélníku
Width	Šířka hotspotového obdélníku
Height	Výška hotspotového obdélníku
FieldNames	Jedno nebo více plně kvalifikovaných jmen polí AcroForm oddělených čárkami, středníky nebo řádky. Bílé znaky na začátku a konci každého jména se ořežou. Jedno jméno se zapíše jako /T v podobě textového řetězce; dvě a více jmen se zapíšou jako /T v podobě pole textových řetězců
HideFlag	Volí směr změny viditelnosti. Nenulová hodnota uvedená pole skryje (/H true). Nula je zobrazí (/H false)
Options	Bitová maska řídící vzhled odkazu. Bit 0 (hodnota 1): nakreslit ohraničení kolem hotspotového obdélníku. Bity 1–3 volí režim zvýraznění při kliknutí (2 = Invert, 4 = Outline, 8 = Push); není-li nastaven žádný bit zvýraznění, použije se výchozí Invert. Stejná konvence jako u AddLinkToWeb / AddLinkToNamedAction

Poznámky

Režimy PDF/A a PDF/X-6 akce Hide odmítají a vrací 0; vyžaduje se PDF 1.2 nebo novější