AddLinkToHideField
Annotazioni e link sensibili, Campi modulo e AcroForms
Descrizione
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 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 | Coordinata orizzontale del bordo sinistro del rettangolo sensibile |
|---|---|
| Top | Coordinata verticale del bordo superiore del rettangolo sensibile |
| Width | Larghezza del rettangolo sensibile |
| Height | Altezza del rettangolo sensibile |
| FieldNames | Uno o più nomi di campo AcroForm completi, separati da virgole, punti e virgola o interruzioni di riga. Gli spazi bianchi iniziali e finali di ciascun nome vengono rimossi. Un nome singolo emette /T come stringa di testo; due o più nomi emettono /T come array di stringhe di testo. |
| HideFlag | Seleziona la direzione della visibilità. Un valore diverso da zero nasconde i campi elencati (/H true). Zero li mostra (/H false). |
| Options | Bitmask che controlla l'aspetto del link. Bit 0 (valore 1): disegna un bordo attorno al rettangolo sensibile. I bit 1–3 selezionano la modalità di evidenziazione al clic (2 = Invert, 4 = Outline, 8 = Push); quando nessun bit di evidenziazione è impostato, viene usato Invert come valore predefinito. Stessa convenzione di AddLinkToWeb / AddLinkToNamedAction. |
Note
Le modalità PDF/A e PDF/X-6 respingono le azioni Hide e restituiscono 0; è richiesto PDF 1.2 o successivo