Lavorare con i campi modulo
Un documento che contiene spazi vuoti di riempimento (campi) è noto come modulo. Ad esempio, è possibile creare un modulo di registrazione in Microsoft Word che utilizza elenchi a discesa da cui gli utenti possono selezionare le voci. Un campo modulo è un percorso in cui viene memorizzato un particolare tipo di dati, ad esempio un nome o un indirizzo. I campi modulo in Microsoft Word includono input di testo, Casella combinata e casella di controllo.
È possibile utilizzare i campi modulo nel progetto per “comunicare” con gli utenti. Ad esempio, si crea un documento il cui contenuto è protetto, ma solo i campi modulo sono modificabili. Gli utenti possono inserire i dati nei campi del modulo e inviare il documento. L’applicazione che utilizza Aspose.Words può recuperare i dati dai campi modulo ed elaborarli.
Inserire i campi modulo nel documento tramite codice è facile. DocumentBuilder ha metodi speciali per inserirli, uno per ogni tipo di campo modulo. Ciascuno dei metodi accetta un parametro string che rappresenta il nome del campo modulo. Il nome può essere una stringa vuota. Se tuttavia si specifica un nome per il campo modulo, viene creato automaticamente un segnalibro con lo stesso nome.
Inserimento di campi modulo
I campi modulo sono un caso particolare di campi Word che consente “interazione” con l’utente. I campi modulo in Microsoft Word includono casella di testo, casella combinata e casella di controllo.
DocumentBuilder
L’esempio di codice seguente mostra come inserire un campo modulo combobox in un documento:
Ottenere campi modulo
Una raccolta di campi modulo è rappresentata dalla classe FormFieldCollection che può essere recuperata utilizzando la proprietà FormFields. Ciò significa che è possibile ottenere campi modulo contenuti in qualsiasi nodo documento, incluso il documento stesso.
L’esempio di codice seguente mostra come ottenere una raccolta di campi modulo:
È possibile ottenere un particolare campo modulo dal suo indice o nome.
L’esempio di codice seguente mostra come accedere ai campi modulo:
Le proprietà FormField consentono di lavorare con nome campo modulo, tipo e risultato.
L’esempio di codice seguente mostra come utilizzare il nome, il tipo e il risultato del campo modulo: