Arbeiten mit Sektionen
Manchmal wollen Sie ein Dokument, das nicht die gleiche Formatierung auf allen Seiten hat. Zum Beispiel müssen Sie Seitennummernformate ändern, unterschiedliche Seitengröße und Orientierung haben oder die erste Dokumentseite als Titelseite ohne Nummerierung haben. Das können Sie mit Abschnitten erreichen.
Sektionen sind Level-Knoten, die Header und Footer steuern, Orientierung, Spalten, Margen, Seitennummernformatierung und andere.
Aspose.Words ermöglicht es Ihnen, Abschnitte zu verwalten, ein Dokument in Abschnitte zu teilen und Formatierungsänderungen vorzunehmen, die nur für einen bestimmten Abschnitt gelten. Aspose.Words speichert Informationen über Abschnittsformatierungen wie Kopfzeilen und Fußzeilen, Seitenaufstellung und Spalteneinstellungen im Abschnittsbruch.
Dieser Artikel erklärt, wie man mit Abschnitten und Abschnittsbrüchen arbeitet.
Was Abschnitt und Abschnittsbruch ist
Die Dokumente werden von der Section und SectionCollection Klassen. Abschnittsobjekte sind unmittelbare Kinder der Document und über den Sections Eigentum. Sie können diese Knoten verwalten, indem Sie einige Methoden wie Remove, Add, IndexOf, und andere.
Abschnittsbruch ist eine Option, die Dokumentseiten in Abschnitte mit anpassbaren Layouts teilt.
Arten eines Abschnitts Bruch
Aspose.Words ermöglicht es Ihnen, Dokumente zu spalten und zu formatieren, indem verschiedene Abschnittsunterbrechungen der BreakType Aufzählung:
- AbschnittBreakContinuous
- SektionBreakNewColumn
- SektionBreakNewPage
- AbschnittBreakEvenPage
- AbschnittBreakOddPage
Sie können auch die SectionStart Aufzählung, um einen Bruchtyp zu wählen, der nur für den ersten Abschnitt wie NewColumn, NewPage, EvenPage und OddPage gilt.
Verwalten einer Sektion
Da ein Abschnitt ein normaler Kompositknoten ist, ist die gesamte Knotenmanipulation API kann verwendet werden, um Abschnitte zu manipulieren: zu ergänzen, zu entfernen und andere Operationen auf Abschnitten. Sie können mehr über Knoten im Artikel lesen Aspose.Words Document Object Model (DOM).
Auf der anderen Seite können Sie auch die DocumentBuilder API mit Abschnitten zu arbeiten. In diesem Artikel werden wir uns auf diese besondere Art der Arbeit mit Sektionen konzentrieren.
Einfügen oder Entfernen eines Abschnitts
Aspose.Words ermöglicht es Ihnen, einen Schnitt in Text einzufügen InsertBreak Methode.
Das folgende Codebeispiel zeigt, wie ein Schnittbruch in ein Dokument eingefügt werden kann:
Verwenden Sie die Remove Verfahren zum Löschen eines Abschnittsbruchs. Wenn Sie keinen bestimmten Abschnittsbruch entfernen müssen und stattdessen den Inhalt dieses Abschnitts löschen müssen, können Sie den ClearContent Methode.
Das folgende Codebeispiel zeigt, wie Abschnitte bricht:
Abschnitt verschieben
Wenn Sie einen Abschnitt von einer Position in eine andere in Ihrem Dokument verschieben möchten, müssen Sie den Index dieses Abschnitts erhalten. Aspose.Words ermöglicht es Ihnen, eine Sektionsposition von einer SectionCollection. Sie können die Sections Eigentum, um alle Abschnitte in Ihrem Dokument zu erhalten. Aber wenn Sie nur den ersten Abschnitt erhalten möchten, können Sie die FirstSection Eigentum.
Das folgende Codebeispiel zeigt, wie man auf den ersten Abschnitt zugreift und durch die Kinder eines Verbundknotens iteriert:
Ein Abschnittslayout angeben
Manchmal möchten Sie, dass Ihr Dokument besser aussieht, indem Sie kreative Layouts für verschiedene Dokumentabschnitte erstellen. Wenn Sie den Typ des aktuellen Abschnittsrasters angeben möchten, können Sie einen Abschnittslayout-Modus mit dem SectionLayoutMode Aufzählung:
- Standard
- Grid
- LineGrid
- SnapToChars
Das folgende Codebeispiel zeigt, wie die Anzahl der Zeilen begrenzt werden kann, die jede Seite haben kann:
Abschnitt bearbeiten
Wenn Sie einen neuen Abschnitt zu Ihrem Dokument hinzufügen, gibt es keinen Körper oder Absatz, den Sie bearbeiten können. Aspose.Words Sie können sicherstellen, dass ein Abschnitt einen Körper mit mindestens einem Absatz mit der EnsureMinimum Methode – es wird automatisch einen Body (oder HeaderFooter)-Knoten zum Dokument hinzufügen und dann einen Absatz dazu hinzufügen.
Das folgende Codebeispiel zeigt, wie man einen neuen Abschnittsknoten mit EnsureMinimum:
Inhalt anhängen oder ausgeben
Wenn Sie am Anfang/Ende eines Abschnitts eine Form zeichnen oder Text oder Bild hinzufügen möchten, können Sie die AppendContent und PrependContent Methoden der Section Klasse.
Das folgende Codebeispiel zeigt, wie Inhalte eines vorhandenen Abschnitts angehängt werden können:
Ein Abschnitt einfügen
Aspose.Words ermöglicht es Ihnen, einen Abschnitt zu duplizieren, indem Sie eine vollständige Kopie davon mithilfe der deepClone Methode.
Das folgende Codebeispiel zeigt, wie man den ersten Abschnitt in Ihrem Dokument klont:
Abschnitte zwischen Dokumenten kopieren
In einigen Fällen können Sie große Dokumente mit vielen Abschnitten haben und möchten den Inhalt eines Abschnitts von einem Dokument in ein anderes kopieren.
Aspose.Words ermöglicht es Ihnen, Abschnitte zwischen Dokumenten zu kopieren ImportNode Methode.
Das folgende Codebeispiel zeigt, wie Abschnitte zwischen Dokumenten kopiert werden können:
Arbeit mit Sektion Header und Footer
Die Grundregeln für die Darstellung eines Headers oder Footer für jeden Abschnitt sind ganz einfach:
ANHANG Hat der Abschnitt keine eigenen Kopf-/Fußgänger bestimmter Art, so wird er aus dem vorherigen Abschnitt entnommen. 2. Die Art des auf der Seite angezeigten Headers/Fußers wird durch die “Different First Page” und die “Different Odd & Even Seiten”-Sektionseinstellungen gesteuert – wenn sie deaktiviert sind, werden die eigenen Titel des Abschnitts ignoriert.
Das folgende Codebeispiel zeigt, wie man 2 Abschnitte mit verschiedenen Headern erstellt:
Wenn Sie den Text von Kopfzeilen und Fußzeilen entfernen möchten, ohne zu entfernen HeaderFooter Objekte in Ihrem Dokument, können Sie die ClearHeadersFooters Methode. Darüber hinaus können Sie die DeleteHeaderFooterShapes Methode, um alle Formen von Kopf- und Fußzeilen in Ihrem Dokument zu entfernen.
Das folgende Codebeispiel zeigt, wie der Inhalt aller Kopf- und Fußzeilen in einem Abschnitt geklärt werden kann:
Das folgende Codebeispiel, wie man alle Formen von allen Kopfschuhen in einem Abschnitt entfernt:
Seiteneigenschaften in einem Abschnitt anpassen
Vor dem Drucken einer Seite oder eines Dokuments können Sie die Größe und das Layout einer einzelnen Seite oder des gesamten Dokuments anpassen und ändern möchten. Mit dem Seitenaufbau können Sie die Einstellungen von Dokumentseiten wie Margen, Orientierung und Größe zum Drucken von verschiedenen ersten Seiten oder ungeraden Seiten ändern.
Aspose.Words ermöglicht die Anpassung von Seiten- und Schnitteigenschaften durch die PageSetup Klasse.
Das folgende Codebeispiel zeigt, wie man solche Eigenschaften wie Seitengröße und Orientierung für den aktuellen Abschnitt einstellt:
Das folgende Codebeispiel zeigt, wie man die Seiteneigenschaften in allen Abschnitten verändert: