Wie man mit Listen in .NET arbeitet

Schritt 1: Eine Liste auf einen Absatz anwenden

Verwenden Sie ListFormat.ApplyBulletDefault() oder ApplyNumberDefault() in der Formatierung eines Absatzes, um Word’s Standardaufzählungs- oder Nummerierungsliste in einem Aufruf anzuwenden — dies ist der schnellste Weg, eine Standardliste zu verwenden. Für ein bestimmtes vordefiniertes Format anstelle des Standards rufen Sie Document.Lists (ein ListCollection) .Add(listTemplate) mit einem ListTemplate Wert wie BulletDisk, BulletSquare, NumberArabicDot oder NumberUppercaseRomanDot auf, um ein List aus einem der integrierten Formate von Word zu erstellen, oder AddSingleLevelList(listTemplate) für eine ein-stufige Variante. Sobald ein Absatz eine Listformatierung hat, gibt ListFormat.IsListItem true zurück, und ListFormat.List/ListLevelNumber identifizieren, welche Liste und Ebene verwendet werden.

Schritt 2: Einer neuen Gruppe von Absätzen eine unabhängige Nummerierung zuweisen

Absätze, deren ListFormat.List auf dasselbe gemeinsam genutzte List-Objekt verweist, setzen denselben Zähler fort. Wenn eine neue Gruppe von Absätzen eine Nummerierung benötigt, die unabhängig von 1 neu startet, rufen Sie ListCollection.AddCopy(srcList) auf, um eine vorhandene Listendefinition zu duplizieren, und wenden Sie dann die Kopie auf die neuen Absätze an, anstatt das Original zu verwenden. ListCollection.GetListByListId(listId) ruft eine bestimmte Liste anhand ihres ListId ab, wenn Sie eine vorhandene nachschlagen statt eine neue zu erstellen, und Count gibt an, wie viele Listen das Dokument derzeit enthält.

Schritt 3: Einen Absatz zwischen Listenebenen verschieben

Verwenden Sie ListFormat.ListIndent(), um einen Absatz eine Ebene tiefer in seine Liste zu verschieben, und ListOutdent(), um ihn eine Ebene höher zu verschieben — dieselben Vorgänge, die Word für Tab und Shift+Tab am Anfang eines Listenelements ausführt. Bevorzugen Sie diese Methoden gegenüber dem direkten Setzen von ListLevelNumber, da sie die Listformatierung des Absatzes intern konsistent halten. Rufen Sie RemoveNumbers() auf, um die Listformatierung eines Absatzes vollständig zu entfernen.

Schritt 4: Das Nummerierungsformat einer Listenebene anpassen

Greifen Sie über List.ListLevels (ein ListLevelCollection) auf eine bestimmte Ebene zu und setzen Sie dann ListLevel.NumberStyle (ein NumberStyle-Wert wie Arabic, UppercaseRoman, LowercaseLetter oder Bullet) sowie NumberFormat — die Formatzeichenkette, die die Zahl mit einem Literal wie einem Punkt oder einer Klammer kombiniert — zusammen, da ein nicht übereinstimmendes Paar zu unerwarteter Darstellung führt. StartAt legt die Startnummer der Ebene fest und RestartAfterLevel bestimmt, welcher höhere Ebenen-Inkrement diesen Ebenenzähler zurücksetzt — setzen Sie es explizit bei verschachtelten Listen, anstatt sich auf das Standard-Neustartverhalten zu verlassen. Alignment (Left, Center, Right) und TrailingCharacter (Tab, Space, Nothing) steuern die Position des Labels und den Trenner zwischen dem Label und dem Absatztext, zusammen mit TabPosition, NumberPosition und TextPosition für ein präzises Layout. IsLegal erzwingt eine juristische Nummerierung (immer arabisch) unabhängig von NumberStyle.

Schritt 5: Einen Bildaufzählungszeichen zu einer Listenebene hinzufügen

Rufen Sie ListLevel.CreatePictureBullet() für die Zielebene auf, um eine Bild-Aufzählungszeichen-Definition zu erstellen, und geben Sie anschließend das ImageData des Aufzählungszeichens an, bevor Sie vorhandene Text-Aufzählungszeichen-Formatierungen auf derselben Ebene entfernen. Rufen Sie DeletePictureBullet() auf, um ein Bild-Aufzählungszeichen zu entfernen und zur textbasierten Aufzählungszeichen-Formatierung zurückzukehren.

Schritt 6: Das gerenderte Label eines Listenelements untersuchen

ListLabel beschreibt das tatsächlich für eine Listenelement-Instanz gerenderte Etikett, das über die Absatzformatierung des Elements erreicht wird. LabelString ist der wörtliche Text, den Word anzeigt – zum Beispiel „3.“ oder „•“ – LabelValue ist der zugrunde liegende numerische Wert, und Font ist die eigene Formatierung des Etiketts, unabhängig von der Formatierung des Absatztexts. Um den Wert eines Etiketts an einer beliebigen Position in der Sequenz zu berechnen, ohne die gesamte Liste zu rendern, rufen Sie ListLevel.GetEffectiveValue(index, numberStyle, customNumberStyleFormat) auf.