Come lavorare con le liste in .NET

Passo 1: Applicare un elenco a un paragrafo

Usa ListFormat.ApplyBulletDefault() o ApplyNumberDefault() sulla formattazione di un paragrafo per applicare l’elenco puntato o numerato predefinito di Word in un’unica chiamata — questo è il modo più rapido per applicare un elenco standard. Per un formato predefinito specifico invece del predefinito, chiama Document.Lists (un ListCollection) .Add(listTemplate) con un valore ListTemplate come BulletDisk, BulletSquare, NumberArabicDot o NumberUppercaseRomanDot per creare un List da uno dei formati integrati di Word, o AddSingleLevelList(listTemplate) per una variante a livello singolo. Una volta che un paragrafo ha la formattazione dell’elenco, ListFormat.IsListItem segnala true, e ListFormat.List/ListLevelNumber identificano quale elenco e livello utilizza.

Passo 2: Assegnare a un nuovo gruppo di paragrafi una numerazione indipendente

I paragrafi il cui ListFormat.List punta allo stesso oggetto List condiviso continuano lo stesso contatore. Quando un nuovo gruppo di paragrafi richiede una numerazione che ricomincia da 1 in modo indipendente, chiama ListCollection.AddCopy(srcList) per duplicare una definizione di elenco esistente, quindi applica la copia ai nuovi paragrafi invece di riutilizzare l’originale. ListCollection.GetListByListId(listId) recupera un elenco specifico tramite il suo ListId quando è necessario trovarne uno anziché crearne uno, e Count segnala quante liste ha attualmente il documento.

Passo 3: Sposta un paragrafo tra i livelli dell’elenco

Usa ListFormat.ListIndent() per spostare un paragrafo di un livello più in profondità nella sua lista, e ListOutdent() per spostarlo di un livello più in alto — le stesse operazioni che Word esegue con Tab e Shift+Tab all’inizio di un paragrafo di elenco. Preferisci questi metodi rispetto all’impostazione diretta di ListLevelNumber, poiché mantengono la formattazione dell’elenco del paragrafo coerente internamente. Chiama RemoveNumbers() per rimuovere completamente la formattazione dell’elenco da un paragrafo.

Passo 4: Personalizza il formato di numerazione di un livello dell’elenco

Raggiungi un livello specifico tramite List.ListLevels (un ListLevelCollection), quindi imposta ListLevel.NumberStyle (un valore NumberStyle come Arabic, UppercaseRoman, LowercaseLetter o Bullet) e NumberFormat — la stringa di formato che combina il numero con testo letterale come un punto o una parentesi — insieme, poiché una coppia non corrispondente produce un rendering inatteso. StartAt imposta il numero di partenza del livello, e RestartAfterLevel controlla quale incremento del livello superiore riavvia il contatore di questo livello — impostalo esplicitamente nelle liste nidificate anziché fare affidamento sul comportamento di riavvio predefinito. Alignment (Left, Center, Right) e TrailingCharacter (Tab, Space, Nothing) controllano la posizione dell’etichetta e il separatore tra l’etichetta e il testo del paragrafo, insieme a TabPosition, NumberPosition e TextPosition per una disposizione precisa. IsLegal forza la numerazione in stile legale (sempre arabo) indipendentemente da NumberStyle.

Passo 5: Aggiungi un bullet immagine a un livello dell’elenco

Chiama ListLevel.CreatePictureBullet() sul livello di destinazione per creare una definizione di bullet immagine, quindi fornisci il ImageData del bullet prima di rimuovere qualsiasi formattazione di bullet testuale esistente nello stesso livello. Chiama DeletePictureBullet() per rimuovere un bullet immagine e tornare alla formattazione di bullet basata su testo.

Passo 6: Ispeziona l’etichetta renderizzata di un elemento dell’elenco

ListLabel descrive l’etichetta effettivamente renderizzata per un’istanza di elemento dell’elenco, ottenuta dalla formattazione del paragrafo dell’elemento. LabelString è il testo letterale visualizzato da Word — come “3.” o “•” — LabelValue è il valore numerico sottostante, e Font è la formattazione propria dell’etichetta, indipendente dalla formattazione del testo del paragrafo. Per calcolare il valore di un’etichetta in una posizione arbitraria della sequenza senza renderizzare l’intero elenco, chiama ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat).