AddLinkToHideFieldA
Annotazioni e collegamenti sensibili, campi modulo e AcroForm
Descrizione
Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a AddLinkToHideField e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode
Aggiunge alla pagina un rettangolo sensibile che attiva un'azione PDF hide. L'azione modifica la visibilità di campi AcroForm senza JavaScript ed è definita in ISO 32000-1 §12.6.4.10, Tabella 196
Uso tipico: un collegamento “Mostra dettagli” / “Nascondi dettagli” nel layout di un modulo oppure gruppi di campi che si escludono a vicenda, nei quali il clic su un collegamento nasconde un gruppo e ne mostra un altro; combinare due chiamate AddLinkToHideField con valori HideFlag opposti
Usare la funzione SetAnnotBorderColor per cambiare il colore del bordo dell'area sensibile
Sintassi
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);Parametri
| Left | La coordinata orizzontale del bordo sinistro del rettangolo hotspot |
|---|---|
| Top | La coordinata verticale del bordo superiore del rettangolo hotspot |
| Width | La larghezza del rettangolo hotspot |
| Height | L'altezza del rettangolo hotspot |
| FieldNames | Uno o più nomi completi di campi AcroForm, separati da virgole, punti e virgola o interruzioni di riga. Gli spazi iniziali e finali di ciascun nome vengono rimossi. Un singolo nome emette /T come stringa di testo; due o più nomi emettono /T come matrice di stringhe di testo |
| HideFlag | Seleziona la direzione: nonzero nasconde i campi (/H true), zero li mostra (/H false) |
| Options | Maschera di bit che controlla l'aspetto del collegamento. Bit 0 (valore 1): disegna un bordo intorno al rettangolo sensibile al clic. I bit 1–3 selezionano la modalità di evidenziazione al clic (2 = Invert, 4 = Outline, 8 = Push); se non è impostato alcun bit di evidenziazione, viene usato Invert per impostazione predefinita. Stessa convenzione di AddLinkToWeb / AddLinkToNamedAction |
Note
L'annotazione è compatibile PDF/A perché non referenzia risorse esterne. Richiede PDF 1.2 o successivo