Lavorare con Liste
Una lista in un Microsoft Word documento è un insieme di proprietà di formattazione elenco. Le liste possono essere utilizzate nei documenti per formattare, organizzare e sottolineare il testo. Le liste sono un ottimo modo per organizzare i dati nei documenti, e rendono più facile per i lettori capire punti chiave.
Ogni elenco può avere fino a 9 livelli e proprietà di formattazione, come lo stile del numero, il valore di inizio, l’indent, la posizione della scheda, e altri sono definiti separatamente per ogni livello.
Questo articolo descrive il funzionamento programmatico con le liste utilizzando Aspose.Words.
Creazione di liste applicando la formattazione dell’elenco
Aspose.Words consente la facile creazione di liste applicando la formattazione dell’elenco. DocumentBuilder fornisce ListFormat proprietà che ritorna ListFormat oggetto. Questo oggetto ha diversi metodi per avviare e terminare un elenco e per aumentare / diminuire l’indent. Ci sono due tipi generali di elenchi in Microsoft Word: bollettino e numerato:
- Per aprire un elenco, chiama. ListFormat.ApplyBulletDefault
- Per avviare una lista numerata, chiama ListFormat.ApplyNumberDefault
Il proiettile o il numero e la formattazione sono aggiunti al paragrafo corrente e tutti gli altri paragrafi creati utilizzando DocumentBuilder fino a quando RemoveNumbers è chiamato per fermare la formattazione elenco.
Nei documenti di Word, le liste possono consistere fino a nove livelli. La formattazione dell’elenco per ogni livello specifica ciò che il proiettile o il numero viene utilizzato, l’indent sinistro, lo spazio tra il proiettile e il testo ecc. I seguenti metodi cambiano il livello dell’elenco e applicano le proprietà di formattazione del nuovo livello:
- No. Per aumentare il livello di elenco del paragrafo corrente da un livello, chiama ListFormat.ListIndent
- No. Per diminuire il livello di elenco del paragrafo corrente da un livello, chiama ListFormat.ListOutdent
I metodi cambiano il livello dell’elenco e applicano le proprietà di formattazione del nuovo livello.
Il seguente esempio di codice mostra come costruire un elenco multilivello:
Specificare la formattazione per un livello di lista
Gli oggetti a livello di elenco vengono creati automaticamente quando viene creato un elenco. Utilizzare le proprietà e i metodi della ListLevel classe per controllare la formattazione dei singoli livelli di un elenco.
Riavviare l’elenco per ogni sezione
È possibile riavviare un elenco per ogni sezione utilizzando IsRestartAtEachSection proprieta'. Si noti che questa opzione è supportata solo in formati di documento RTF, DOC e DOCX. Questa opzione sarà scritta a DOCX solo se OoxmlCompliance è più alta allora Ecma376.
Il seguente esempio di codice mostra come creare un elenco e riavviarlo per ogni sezione: