Panoramica del Costruttore di documenti
DocumentBuilder è una classe potente che associa Document e consente di costruire documenti dinamici da zero o aggiungere nuovi elementi a uno esistente.
DocumentBuilder fornisce metodi per inserire testo, caselle di controllo, oggetti ole, paragrafi, elenchi, tabelle, immagini e altri elementi di contenuto. Consente di specificare font, paragrafo o formattazione della sezione e di eseguire altre operazioni.
Costruttore di documenti o Aspose.Words DOM
DocumentBuilder complementi classi e metodi disponibili Aspose.Words Document Object Model (DOM) semplificare le attività di costruzione dei documenti più comuni. Cioè, è possibile creare e modificare il contenuto dei documenti sia attraverso il Aspose.Words DOM, che richiede una buona comprensione della struttura dell’albero, e utilizzando il DocumentBuilder. The DocumentBuilder è una “facade” per il complesso Document struttura che consente di inserire rapidamente e facilmente contenuti e formattazione.
Operazioni possibili con DocumentBuilder sono anche possibili quando si utilizzano le classi Aspose.Words DOM direttamente. Tuttavia, utilizzando Aspose.Words DOM classi di solito richiedono più linee di codice che utilizzare DocumentBuilder.
Navigazione dei documenti
La navigazione dei documenti si basa sul concetto di un cursore virtuale, con il quale si può spostare in un’altra posizione nel documento utilizzando vari DocumentBuilder.MoveToXXX metodi quali MoveToDocumentStart e MoveToField. Questo cursore virtuale indica dove verrà inserito il testo quando si chiamano i metodi Write, Writeln, InsertBreak, e altri. Vedi il seguente articolo “Navigation with Cursor” per saperne di più sul cursore virtuale.
Il seguente esempio di codice mostra come navigare in un segnalibro:
Costruzione e modifica dei documenti
Aspose.Words API fornisce diverse classi che sono responsabili della formattazione di vari elementi di un documento. Ciascuna delle classi incapsula proprietà di formattazione relative a un elemento di documento specifico, come testo, paragrafo, sezione e altri. Per esempio, il Font classe rappresenta proprietà di formattazione dei caratteri, la ParagraphFormat classe rappresenta le proprietà di formattazione del paragrafo, e così via. Gli oggetti di queste classi sono restituiti dalla corrispondente DocumentBuilder proprietà, che hanno gli stessi nomi delle classi. Pertanto, è possibile accedervi e impostare la formattazione desiderata durante la costruzione del documento.
È inoltre possibile inserire testo, casella di controllo, oggetto ole, immagini, segnalibri, campi di forma e altri elementi di documento nella posizione del cursore utilizzando il Write metodo o qualsiasi di DocumentBuilder.InsertXXX metodi, come InsertField, InsertHtml, e metodi simili.
Vediamo come creare un semplice documento utilizzando il DocumentBuilder.
Creare un documento utilizzando DocumentBuilder
Per iniziare, è necessario creare un DocumentBuilder e associarlo a un Document oggetto. Si crea una nuova istanza DocumentBuilder chiamando il suo costruttore e passarlo a un Document oggetto per attaccamento al costruttore.
Per inserire un testo, passare la stringa di testo è necessario inserire nel documento al Write metodo.
Il seguente esempio di codice mostra come creare un semplice documento utilizzando un costruttore di documenti.
Specificare la formattazione del documento
The Font la proprietà definisce la formattazione del testo. Questo oggetto contiene diversi attributi di carattere (nome di testo, dimensione del carattere, colore e così via). Alcuni attributi di carattere importanti sono anche rappresentati da DocumentBuilder proprietà per consentire di accedervi direttamente. Questi sono i Font.Bold, Font.Italic, e Font.Underline proprietà booleane.
Il seguente esempio di codice mostra come inserire un testo formattato utilizzando DocumentBuilder:
- No. Font specifica la formattazione del carattere che verrà applicata a tutto il testo inserito dalla posizione corrente nel documento in poi.
- No. ParagraphFormat specifica la formattazione del paragrafo per la corrente e tutti i paragrafi da inserire.
- No. PageSetup specifica le proprietà della pagina e della sezione per la sezione corrente e l’intera sezione che verrà inserita.
- No. CellFormat e RowFormat specificare le proprietà di formattazione che verranno applicate alle celle di tabella e alle righe dalla posizione corrente nel documento in poi.
In questa situazione, “corrente” significa la posizione, paragrafo, sezione, cella o riga in cui il cursore è.