AddLinkToHideFieldA

Anotace a aktivní oblasti odkazů, Pole formuláře a AcroForms

Popis

Koncové A označuje vstupní bod DLL pro ANSI (char); povrch ActiveX/COM vystavuje jen Unicode formu. Chování je shodné s AddLinkToHideField a řetězcové argumenty se interpretují podle aktuální kódové stránky SetAnsiMode

Přidá na vybranou stránku klikatelný hotspot obdélník, který při aktivaci spustí PDF akci hide. Akce hide přepíná viditelnost jednoho nebo více AcroForm polí, takže dynamické zobrazování a skrývání funguje bez JavaScriptu. Akce je definována v ISO 32000-1 §12.6.4.10, Tabulka 196

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

Barvu rámečku aktivní oblasti změníte funkcí SetAnnotBorderColor

Syntaxe

Delphi

Function DLAddLinkToHideFieldA(InstanceID: Integer; Left, Top, Width, Height: Double; FieldNames: PAnsiChar; HideFlag, Options: Integer): Integer;

DLL

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

Parametry

LeftVodorovná souřadnice levého okraje obdélníku aktivní oblasti
TopSvislá souřadnice horního okraje obdélníku aktivní oblasti
WidthŠířka obdélníku aktivní oblasti
HeightVýška obdélníku aktivní oblasti
FieldNamesJeden nebo více plně kvalifikovaných názvů polí AcroForm oddělených čárkami, středníky nebo koncemi řádků. Bílé znaky na začátku a konci každého názvu se ořežou. Jeden název zapíše /T jako textový řetězec; dva a více zapíše /T jako pole textových řetězců
HideFlagVybere směr viditelnosti. Nenulová hodnota skryje vypsaná pole (/H true). Nula je zobrazí (/H false)
OptionsBitová maska řídící vzhled odkazu. Bit 0 (hodnota 1): nakreslit okraj kolem hotspot obdélníku. Bity 1–3 volí režim zvýraznění po kliknutí (2 = Invert, 4 = Outline, 8 = Push); pokud není nastaven žádný bit zvýraznění, použije se výchozí Invert. Stejná konvence jako AddLinkToWeb / AddLinkToNamedAction

Poznámky

Anotace je kompatibilní s PDF/A, protože neodkazuje na žádný externí zdroj. Vyžaduje PDF 1.2 a novější