ListFormat

ListFormat class

Consente di controllare quale formattazione di elenco viene applicata a un paragrafo.

Per saperne di più, visita ilLavorare con gli elenchi articolo di documentazione.

public class ListFormat

Proprietà

NomeDescrizione
IsListItem { get; }Vero quando al paragrafo è stata applicata la formattazione puntata o numerata.
List { get; set; }Ottiene o imposta l’elenco di cui questo paragrafo è membro.
ListLevel { get; }Restituisce la formattazione a livello di elenco più eventuali sovrascritture di formattazione applicate al paragrafo corrente.
ListLevelNumber { get; set; }Ottiene o imposta il numero del livello di elenco (da 0 a 8) per il paragrafo.

Metodi

NomeDescrizione
ApplyBulletDefault()Avvia un nuovo elenco puntato predefinito e lo applica al paragrafo.
ApplyNumberDefault()Avvia un nuovo elenco numerato predefinito e lo applica al paragrafo.
ListIndent()Aumenta di un livello il livello dell’elenco del paragrafo corrente.
ListOutdent()Diminuisce di un livello il livello dell’elenco del paragrafo corrente.
RemoveNumbers()Rimuove numeri o elenchi puntati dal paragrafo corrente e imposta il livello dell’elenco su zero.

Osservazioni

Un paragrafo in un documento Microsoft Word può essere puntato o numerato. Quando un paragrafo è puntato o numerato, si dice che al paragrafo viene applicata la formattazione di elenco.

Non si creano oggetti delListFormat classe direttamente. AccediListFormatCome proprietà di un altro oggetto a cui è associata la formattazione di elenco. Al momento, gli oggetti a cui è associata la formattazione di elenco sono:Paragraph , Style EDocumentBuilder.

ListFormat di unParagraph specifica quale formattazione e livello di elenco vengono applicati a quel particolare paragrafo.

ListFormat di unStyle (applicable solo agli stili di paragrafo) consente di specificare quale formattazione di elenco e livello di elenco vengono applicati a tutti i paragrafi di quello stile particolare.

ListFormat di unDocumentBuilder fornisce l’accesso alla formattazione dell’elenco nella posizione corrente del cursore all’interno dell’DocumentBuilder.

La formattazione dell’elenco stesso è memorizzata all’interno di unList Oggetto memorizzato separatamente dai paragrafi. Gli oggetti elenco sono memorizzati all’interno di unListCollection collezione. C’è un singolo ListCollection raccolta perDocument.

paragrafi non appartengono fisicamente a un elenco. I paragrafi fanno semplicemente riferimento a un particolare oggetto elenco tramiteList property e un livello particolare nell’elenco tramite ilListLevelNumber property. Impostando queste due proprietà puoi controllare quali elenchi puntati e numerati vengono applicati a un paragrafo.

Esempi

Mostra come lavorare con i livelli degli elenchi.

Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);

Assert.False(builder.ListFormat.IsListItem);

// Un elenco ci consente di organizzare e decorare serie di paragrafi con simboli di prefisso e rientri.
 // Possiamo creare elenchi annidati aumentando il livello di rientro.
 // Possiamo iniziare e terminare un elenco utilizzando la proprietà "ListFormat" di un generatore di documenti.
// Ogni paragrafo che aggiungiamo tra l'inizio e la fine di un elenco diventerà un elemento dell'elenco.
// Di seguito sono riportati due tipi di elenchi che possiamo creare utilizzando un generatore di documenti.
// 1 - Un elenco numerato:
// Gli elenchi numerati creano un ordine logico per i paragrafi numerando ogni elemento.
builder.ListFormat.List = doc.Lists.Add(ListTemplate.NumberDefault);

Assert.True(builder.ListFormat.IsListItem);

// Impostando la proprietà "ListLevelNumber", possiamo aumentare il livello dell'elenco
// per iniziare un sottoelenco autonomo a partire dall'elemento corrente dell'elenco.
// Il modello di elenco di Microsoft Word denominato "NumberDefault" utilizza i numeri per creare livelli di elenco per il primo livello di elenco.
 // I livelli più profondi dell'elenco utilizzano lettere e numeri romani minuscoli.
for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// 2 - Un elenco puntato:
// Questo elenco applicherà un rientro e un simbolo di punto elenco ("•") prima di ogni paragrafo.
// I livelli più profondi di questo elenco utilizzeranno simboli diversi, come "■" e "○".
builder.ListFormat.List = doc.Lists.Add(ListTemplate.BulletDefault);

for (int i = 0; i < 9; i++)
{
    builder.ListFormat.ListLevelNumber = i;
    builder.Writeln("Level " + i);
}

// Possiamo disabilitare la formattazione dell'elenco per non formattare i paragrafi successivi come elenchi deselezionando il flag "Elenco".
builder.ListFormat.List = null;

Assert.False(builder.ListFormat.IsListItem);

doc.Save(ArtifactsDir + "Lists.SpecifyListLevel.docx");

Guarda anche

ListCollection Class ListLabel Class