Arbeiten mit Listen

Eine Liste in einem Microsoft Word-Dokument ist eine Reihe von Absatzformatierungseigenschaften. Listen können in Dokumenten verwendet werden, um Text zu strukturieren, anzuordnen und hervorzuheben. Listen sind eine großartige Möglichkeit, Daten in Dokumenten so zu organisieren, dass es den Lesern erleichtert, wichtige Punkte zu erfassen und zu verstehen.

Jede Liste kann bis zu 9 Ebenen haben und Formatierungseigenschaften wie Zahlenstil, Startwert, Einzug, Tabulatorposition und andere werden für jede Ebene separat definiert.

In Aspose.Words wird die Arbeit mit Listen durch den Lists-Namespace repräsentiert. Das List-Objekt gehört jedoch immer zum ListCollection.

In diesem Artikel wird das programmgesteuerte Arbeiten mit Listen mithilfe von Aspose.Words beschrieben.

Erstellen Sie Listen, indem Sie Listenformatierung anwenden

Aspose.Words ermöglicht die einfache Erstellung von Listen durch Anwenden der Listenformatierung. DocumentBuilder stellt die ListFormat-Eigenschaft bereit, die ein ListFormat-Objekt zurückgibt. Dieses Objekt verfügt über mehrere Methoden, um eine Liste zu beginnen und zu beenden und den Einzug zu vergrößern/verkleinern. Es gibt zwei allgemeine Arten von Listen in Microsoft Word: Listen mit Aufzählungszeichen und nummerierte Listen:

Das Aufzählungszeichen bzw. die Nummer und die Formatierung werden dem aktuellen Absatz und allen weiteren mit DocumentBuilder erstellten Absätzen hinzugefügt, bis RemoveNumbers aufgerufen wird, um die Formatierung von Aufzählungslisten zu stoppen.

In Word-Dokumenten können Listen aus bis zu neun Ebenen bestehen. Die Listenformatierung für jede Ebene gibt an, welches Aufzählungszeichen oder welche Zahl verwendet wird, den linken Einzug, den Abstand zwischen Aufzählungszeichen und Text usw. Die folgenden Methoden ändern die Listenebene und wenden die Formatierungseigenschaften der neuen Ebene an:

  • Um die Listenebene des aktuellen Absatzes um eine Ebene zu erhöhen, rufen Sie ListIndent auf
  • Um die Listenebene des aktuellen Absatzes um eine Ebene zu verringern, rufen Sie ListOutdent auf

Sie können auch die ListLevelNumber-Eigenschaft verwenden, um die Listenebene für den Absatz abzurufen oder festzulegen.

Das folgende Codebeispiel zeigt, wie eine mehrstufige Liste erstellt wird:

Geben Sie die Formatierung für eine Listenebene an

Objekte auf Listenebene werden automatisch erstellt, wenn eine Liste erstellt wird. Verwenden Sie die Eigenschaften und Methoden der ListLevel-Klasse, um die Formatierung einzelner Ebenen einer Liste zu steuern.

Neustartliste für jeden Abschnitt

Mithilfe der IsRestartAtEachSection-Eigenschaft können Sie für jeden Abschnitt eine Liste neu starten. Beachten Sie, dass diese Option nur in den Dokumentformaten RTF, DOC und DOCX unterstützt wird. Diese Option wird nur dann in DOCX geschrieben, wenn OoxmlCompliance höher als Ecma376 ist.

Das folgende Codebeispiel zeigt, wie Sie eine Liste erstellen und für jeden Abschnitt neu starten:

Arbeiten Sie mit Tabellen in C# Arbeiten mit Absätzen in C#