Arbeiten mit Abschnitten
Manchmal möchten Sie ein Dokument, das nicht auf allen Seiten die gleiche Formatierung aufweist. Beispielsweise müssen Sie möglicherweise Seitenzahlenformate ändern, eine andere Seitengröße und -ausrichtung haben oder die erste Dokumentseite als Deckblatt ohne Nummerierung verwenden. Das können Sie mit Abschnitten erreichen.
Abschnitte sind Ebenenknoten, die Kopf- und Fußzeilen, Ausrichtung, Spalten, Ränder, Formatierung von Seitenzahlen und andere steuern.
Mit Aspose.Words können Sie Abschnitte verwalten, ein Dokument in Abschnitte unterteilen und Formatierungsänderungen vornehmen, die nur für einen bestimmten Abschnitt gelten. Aspose.Words speichert Informationen zur Abschnittsformatierung wie Kopf- und Fußzeilen, Seiteneinrichtung und Spalteneinstellungen im Abschnittsumbruch.
In diesem Artikel wird erläutert, wie Sie mit Abschnitten und Abschnittsumbrüchen arbeiten.
Was Abschnitt und Abschnittsumbruch ist
Dokumentabschnitte werden durch die Klassen Section und SectionCollection dargestellt. Abschnittsobjekte sind unmittelbare untergeordnete Elemente des Knotens Document und können über die Eigenschaft Sections aufgerufen werden. Sie können diese Knoten mit einigen Methoden verwalten, z Remove, Add, IndexOf, und andere.
Abschnittsumbruch ist eine Option, die Dokumentseiten in Abschnitte mit anpassbaren Layouts unterteilt.
Arten eines Abschnittsumbruchs
Aspose.Words ermöglicht es Ihnen, Dokumente mit verschiedenen Abschnittsumbrüchen der BreakType-Aufzählung zu teilen und zu formatieren:
- SectionBreakContinuous
- SectionBreakNewColumn
- SectionBreakNewPage
- SectionBreakEvenPage
- SectionBreakOddPage
Sie können auch die SectionStart-Aufzählung verwenden, um einen Umbruchstyp auszuwählen, der nur für den ersten Abschnitt gilt, z. B.: NewColumn, NewPage, EvenPage, und OddPage.
Verwalten eines Abschnitts
Da ein Abschnitt ein normaler zusammengesetzter Knoten ist, kann die gesamte Knotenmanipulation API zum Manipulieren von Abschnitten verwendet werden: zum Hinzufügen, Entfernen und anderen Operationen an Abschnitten. Sie können mehr über Knoten im Artikel lesen Aspose.Words Dokumentenobjektmodell (DOM).
Andererseits können Sie auch DocumentBuilder API verwenden, um mit Abschnitten zu arbeiten. In diesem Artikel werden wir uns auf diese spezielle Art der Arbeit mit Abschnitten konzentrieren.
Einfügen oder Entfernen eines Abschnittsumbruchs
Mit Aspose.Words können Sie mit der InsertBreak-Methode einen Abschnittsumbruch in Text einfügen.
Das folgende Codebeispiel zeigt, wie Sie einen Abschnittsumbruch in ein Dokument einfügen:
Verwenden Sie die Methode Remove, um einen Abschnittsumbruch zu löschen. Wenn Sie einen bestimmten Abschnittsumbruch nicht entfernen und stattdessen den Inhalt dieses Abschnitts löschen müssen, können Sie die Methode ClearContent verwenden.
Das folgende Codebeispiel zeigt, wie Abschnittsumbrüche entfernt werden:
Einen Abschnitt verschieben
Wenn Sie einen Abschnitt in Ihrem Dokument von einer Position an eine andere verschieben möchten, müssen Sie den Index dieses Abschnitts abrufen. Aspose.Words ermöglicht es Ihnen, eine Schnittposition von a SectionCollection zu erhalten. Sie können die Eigenschaft Sections verwenden, um alle Abschnitte in Ihrem Dokument abzurufen. Wenn Sie jedoch nur den ersten Abschnitt erhalten möchten, können Sie die Eigenschaft FirstSection verwenden.
Das folgende Codebeispiel zeigt, wie auf den ersten Abschnitt zugegriffen und die untergeordneten Elemente eines zusammengesetzten Knotens durchlaufen werden:
Angeben eines Abschnittslayouts
Manchmal möchten Sie, dass Ihr Dokument besser aussieht, indem Sie kreative Layouts für verschiedene Dokumentabschnitte erstellen. Wenn Sie den Typ des aktuellen Schnittrasters angeben möchten, können Sie einen Schnittlayoutmodus mit der SectionLayoutMode-Aufzählung auswählen:
- Standard
- Grid
- LineGrid
- SnapToChars
Das folgende Codebeispiel zeigt, wie Sie die Anzahl der Zeilen begrenzen, die jede Seite haben darf:
Einen Abschnitt bearbeiten
Wenn Sie Ihrem Dokument einen neuen Abschnitt hinzufügen, gibt es keinen Text oder Absatz, den Sie bearbeiten können. Mit Aspose.Words können Sie mit der EnsureMinimum –Methode sicherstellen, dass ein Abschnitt einen Text mit mindestens einem Absatz enthält - es wird automatisch ein Textknoten (oder HeaderFooter) zum Dokument hinzugefügt und dann ein Absatz hinzugefügt.
Das folgende Codebeispiel zeigt, wie Sie einen neuen Abschnittsknoten mit EnsureMinimum vorbereiten:
Inhalt anhängen oder voranstellen
Wenn Sie am Anfang / Ende eines Abschnitts eine Form zeichnen oder Text oder Bild hinzufügen möchten, können Sie die Methoden AppendContent und PrependContent der Klasse Section verwenden.
Das folgende Codebeispiel zeigt, wie Sie den Inhalt eines vorhandenen Abschnitts anhängen:
Einen Abschnitt klonen
Mit Aspose.Words können Sie einen Abschnitt duplizieren, indem Sie mit der Methode deepClone eine vollständige Kopie davon erstellen.
Das folgende Codebeispiel zeigt, wie Sie den ersten Abschnitt in Ihrem Dokument klonen:
Abschnitte zwischen Dokumenten kopieren
In einigen Fällen haben Sie möglicherweise große Dokumente mit vielen Abschnitten und möchten den Inhalt eines Abschnitts von einem Dokument in ein anderes kopieren.
Aspose.Words ermöglicht das Kopieren von Abschnitten zwischen Dokumenten mit der ImportNode-Methode.
Das folgende Codebeispiel zeigt, wie Abschnitte zwischen Dokumenten kopiert werden:
Mit Kopf- und Fußzeile des Abschnitts arbeiten
Die Grundregeln für die Anzeige einer Kopf- oder Fußzeile für jeden Abschnitt sind recht einfach:
- Wenn der Abschnitt keine eigenen Kopf- / Fußzeilen eines bestimmten Typs enthält, wird er aus dem vorherigen Abschnitt übernommen.
- Die Art der Kopf– / Fußzeile, die auf der Seite angezeigt wird, wird durch die Abschnittseinstellungen “Andere erste Seite” und “Verschiedene ungerade und gerade Seiten” gesteuert - wenn sie deaktiviert sind, werden die eigenen Titel des Abschnitts ignoriert.
Das folgende Codebeispiel zeigt, wie Sie 2 Abschnitte mit unterschiedlichen Überschriften erstellen:
Wenn Sie den Text von Kopf- und Fußzeilen entfernen möchten, ohne HeaderFooter -Objekte in Ihrem Dokument zu entfernen, können Sie die ClearHeadersFooters -Methode verwenden. Darüber hinaus können Sie die DeleteHeaderFooterShapes -Methode verwenden, um alle Formen aus Kopf- und Fußzeilen in Ihrem Dokument zu entfernen.
Das folgende Codebeispiel zeigt, wie der Inhalt aller Kopf- und Fußzeilen in einem Abschnitt gelöscht wird:
Das folgende Codebeispiel zeigt, wie Sie alle Formen aus allen Kopfzeilen und Fußzeilen in einem Abschnitt entfernen:
Seiteneigenschaften in einem Abschnitt anpassen
Bevor Sie eine Seite oder ein Dokument drucken, möchten Sie möglicherweise die Größe und das Layout einer einzelnen Seite oder des gesamten Dokuments anpassen und ändern. Mit der Seiteneinrichtung können Sie die Einstellungen von Dokumentseiten wie Ränder, Ausrichtung und Größe ändern, um verschiedene erste Seiten oder ungerade Seiten zu drucken.
Mit Aspose.Words können Sie Seiten- und Abschnittseigenschaften mithilfe der Klasse PageSetup anpassen.
Das folgende Codebeispiel zeigt, wie Eigenschaften wie Seitengröße und Ausrichtung für den aktuellen Abschnitt festgelegt werden:
Das folgende Codebeispiel zeigt, wie Sie die Seiteneigenschaften in allen Abschnitten ändern: