Lavorare con le liste
Un elenco in un documento Microsoft Word è un insieme di proprietà di formattazione dell’elenco. Gli elenchi possono essere utilizzati nei documenti per formattare, organizzare e enfatizzare il testo. Gli elenchi sono un ottimo modo per organizzare i dati nei documenti e rendono più facile per i lettori comprendere i punti chiave.
Ogni elenco può avere fino a 9 livelli e le proprietà di formattazione, come lo stile numerico, il valore iniziale, il rientro, la posizione delle tabulazioni e altre, sono definite separatamente per ogni livello.
In questo articolo viene descritto il funzionamento programmatico con gli elenchi utilizzando Aspose.Words.
Creazione di elenchi applicando la formattazione dell’elenco
Aspose.Words consente di creare facilmente liste applicando la formattazione delle liste. DocumentBuilder fornisce la proprietà ListFormat che restituisce un oggetto ListFormat. Questo oggetto ha diversi metodi per iniziare e terminare un elenco e per aumentare/diminuire il rientro. Esistono due tipi generali di elenchi in Microsoft Word: puntato e numerato:
- Per avviare un elenco puntato, chiamare ListFormat.ApplyBulletDefault
- Per avviare un elenco numerato, chiamare ListFormat.ApplyNumberDefault
Il punto elenco o il numero e la formattazione vengono aggiunti al paragrafo corrente e a tutti gli altri paragrafi creati utilizzando DocumentBuilder finché RemoveNumbers non viene chiamato per interrompere la formattazione dell’elenco puntato.
Nei documenti Word, gli elenchi possono essere composti da un massimo di nove livelli. La formattazione dell’elenco per ogni livello specifica quale punto elenco o numero viene utilizzato, il rientro a sinistra, lo spazio tra il punto elenco e il testo, ecc. I metodi seguenti modificano il livello di elenco e applicano le proprietà di formattazione del nuovo livello:
- Per aumentare il livello di elenco del paragrafo corrente di un livello, chiamare ListFormat.ListIndent
- Per ridurre il livello di elenco del paragrafo corrente di un livello, chiamare ListFormat.ListOutdent
I metodi modificano il livello dell’elenco e applicano le proprietà di formattazione del nuovo livello.
Il seguente esempio di codice mostra come creare un elenco multilivello:
Specificare la formattazione per un livello di elenco
Gli oggetti a livello di elenco vengono creati automaticamente quando viene creato un elenco. Utilizzare le proprietà e i metodi della classe ListLevel per controllare la formattazione dei singoli livelli di un elenco.
Restart List per ogni sezione
È possibile riavviare un elenco per ogni sezione utilizzando la proprietà IsRestartAtEachSection. Si noti che questa opzione è supportata solo nei formati di documento RTF, DOC e DOCX. Questa opzione verrà scritta su DOCX solo se OoxmlCompliance è superiore a Ecma376.
Il seguente esempio di codice mostra come creare un elenco e riavviarlo per ogni sezione: