Lavorare con gli elenchi

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 ed enfatizzare il testo. Gli elenchi sono un ottimo modo per organizzare i dati nei documenti e facilitano la comprensione dei punti chiave da parte dei lettori

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 ecc. sono definite separatamente per ciascun livello.

In Aspose.Words, lavorare con gli elenchi è rappresentato dal modulo Lists. Tuttavia, l’oggetto List appartiene sempre alla raccolta ListCollection.

Questo argomento descrive come lavorare a livello di codice con gli elenchi utilizzando Aspose.Words

Creazione di elenchi applicando la formattazione dell’elenco

Aspose.Words consente la facile creazione di elenchi applicando la formattazione dell’elenco. DocumentBuilder fornisce la proprietà DocumentBuilder.list_format 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 ListFormat.apply_bullet_default.
• Per iniziare un elenco numerato, chiamare ListFormat.apply_number_default.

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 ListFormat.remove_numbers 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 ListFormat.list_indent
• Per diminuire il livello dell’elenco del paragrafo corrente di un livello, richiama ListFormat.list_outdent

I metodi modificano il livello dell’elenco e applicano le proprietà di formattazione del nuovo livello.

Puoi anche utilizzare la proprietà ListFormat.list_level_number per ottenere o impostare il livello di elenco per il paragrafo. I livelli dell’elenco sono numerati da 0 a 8.

L’esempio seguente 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. 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à proprietà is_restart_at_each_section. 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: