Panoramica di Document Builder
DocumentBuilder è una classe potente che si associa a Document e consente di creare documenti dinamici da zero o aggiungere nuovi elementi a uno esistente.
DocumentBuilder
Generatore di documenti o Aspose.Words DOM
DocumentBuilder
Le operazioni possibili con DocumentBuilder sono possibili anche quando si usano direttamente le classi di Aspose.Words DOM. Tuttavia, l’utilizzo diretto delle classi Aspose.Words DOM richiede solitamente più righe di codice rispetto all’utilizzo di DocumentBuilder.
Navigazione documenti
La navigazione del documento si basa sul concetto di cursore virtuale, con il quale è possibile spostarsi in un’altra posizione nel documento utilizzando vari metodi DocumentBuilder.MoveToXXX, ad esempio MoveToDocumentStart e MoveToField. Questo cursore virtuale indica dove verrà inserito il testo quando si chiamano i metodi Write, Writeln, InsertBreak, e altri. Vedere il seguente articolo “Navigazione con il cursore” per ulteriori informazioni sul cursore virtuale.
Il seguente esempio di codice mostra come passare a un segnalibro:
Creazione e modifica di documenti
Aspose.Words API fornisce diverse classi responsabili della formattazione di vari elementi di un documento. Ciascuna delle classi incapsula le proprietà di formattazione relative a uno specifico elemento del documento, ad esempio testo, paragrafo, sezione e altri. Ad esempio, la classe Font rappresenta le proprietà di formattazione dei caratteri, la classe ParagraphFormat rappresenta le proprietà di formattazione dei paragrafi e così via. Gli oggetti di queste classi vengono restituiti dalle proprietà DocumentBuilder corrispondenti, che hanno gli stessi nomi delle classi. Pertanto, è possibile accedervi e impostare la formattazione desiderata durante la compilazione del documento.
È inoltre possibile inserire testo, checkbox, oggetto ole, immagini, segnalibri, campi modulo e altri elementi del documento nella posizione del cursore utilizzando il metodo Write o uno qualsiasi dei metodi DocumentBuilder.InsertXXX, ad esempio InsertField, InsertHtml e metodi simili.
Vediamo come creare un semplice documento usando DocumentBuilder.
Creare un documento usando DocumentBuilder
Per iniziare, è necessario creare un DocumentBuilder e associarlo a un oggetto Document. Si crea una nuova istanza di DocumentBuilder chiamando il suo costruttore e passarlo a un oggetto Document per l’allegato al costruttore.
Per inserire un testo, passare la stringa di testo che è necessario inserire nel documento al metodo Write.
L’esempio di codice seguente mostra come creare un documento semplice utilizzando un generatore di documenti.
Specificare la formattazione del documento
La proprietà Font definisce la formattazione del testo. Questo oggetto contiene diversi attributi di carattere (nome del carattere, dimensione del carattere, colore e così via). Alcuni importanti attributi dei font sono rappresentati anche dalle proprietà DocumentBuilder per consentirvi di accedervi direttamente. Queste sono le proprietà booleane Font.Bold, Font.Italic e Font.Underline.
L’esempio di codice seguente mostra come inserire un testo formattato usando DocumentBuilder:
- Font specifica la formattazione dei caratteri che verrà applicata a tutto il testo inserito dalla posizione corrente nel documento in poi.
- ParagraphFormat specifica la formattazione del paragrafo per il paragrafo corrente e per tutti i paragrafi da inserire.
- PageSetup specifica le proprietà pagina e sezione per la sezione corrente e l’intera sezione che verrà inserita.
- CellFormat e RowFormat specificano le proprietà di formattazione che verranno applicate alle celle e alle righe della tabella dalla posizione corrente nel documento in poi.
In questa situazione, “corrente” indica la posizione, il paragrafo, la sezione, la cella o la riga in cui si trova il cursore.