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. Il campo Form è 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, combobox e checkbox.
È 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.
Inserisci 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 checkbox.
DocumentBuilder
L’esempio di codice seguente mostra come inserire un campo modulo combobox in un documento:
Inserire un input di testo
Utilizzare il metodo insertTextInput per inserire una casella di testo nel documento.
L’esempio di codice seguente mostra come inserire un campo modulo di input di testo in un documento:
Inserire una casella di controllo
Chiamare insertCheckBox per inserire un checkbox nel documento.
L’esempio di codice seguente mostra come inserire un campo modulo checkbox in un documento:
Inserire una casella combinata
Chiamare insertComboBox per inserire un combobox nel documento.
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à Range.getFormFields. 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: