Lavorare con gli elenchi
Un elenco in un documento Microsoft Word è un insieme di proprietà di formattazione del paragrafo. Gli elenchi possono essere utilizzati nei documenti per strutturare, organizzare ed evidenziare il testo. Gli elenchi sono un ottimo modo per organizzare i dati nei documenti in modo da facilitare ai lettori l’assorbimento e la comprensione dei punti chiave.
Ogni elenco può avere fino a 9 livelli e le proprietà di formattazione come lo stile del numero, il valore iniziale, il rientro, la posizione della tabulazione e altre sono definite separatamente per ciascun livello.
In Aspose.Words, lavorare con gli elenchi è rappresentato dallo spazio dei nomi Lists. Tuttavia, l’oggetto List appartiene sempre al ListCollection.
Questo articolo descrive l’utilizzo a livello di codice degli elenchi tramite Aspose.Words.
Crea elenchi applicando la formattazione dell’elenco
Aspose.Words consente la facile creazione di elenchi applicando la formattazione dell’elenco. 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: puntati e numerati:
- Per avviare un elenco puntato, chiamare ApplyBulletDefault
- Per iniziare un elenco numerato, chiamare 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é non viene chiamato RemoveNumbers per interrompere la formattazione dell’elenco puntato.
Nei documenti Word gli elenchi possono essere costituiti da un massimo di nove livelli. La formattazione dell’elenco per ciascun livello specifica quale punto elenco o numero viene utilizzato, rientro sinistro, spazio tra il punto elenco e il testo, ecc. I seguenti metodi modificano il livello dell’elenco e applicano le proprietà di formattazione del nuovo livello:
- Per aumentare il livello dell’elenco del paragrafo corrente di un livello, chiamare ListIndent
- Per diminuire il livello dell’elenco del paragrafo corrente di un livello, richiama ListOutdent
Puoi anche utilizzare la proprietà ListLevelNumber per ottenere o impostare il livello di elenco per il paragrafo.
L’esempio di codice seguente mostra come creare un elenco a più livelli:
Specificare la formattazione per un livello di elenco
Gli oggetti a livello di elenco vengono creati automaticamente quando viene creato un elenco. Utilizza le proprietà e i metodi della classe ListLevel per controllare la formattazione dei singoli livelli di un elenco.
Elenco di riavvio per ciascuna sezione
Puoi riavviare un elenco per ogni sezione utilizzando la proprietà IsRestartAtEachSection. Tieni presente che questa opzione è supportata solo nei formati di documenti RTF, DOC e DOCX. Questa opzione verrà scritta in DOCX solo se OoxmlCompliance è superiore a Ecma376.
L’esempio di codice seguente mostra come creare un elenco e riavviarlo per ogni sezione: