Working with Sections
Sometimes you want a document that does not have the same formatting across all pages. For example, you may need to modify page number formats, have different page size and orientation, or have the first document page as a cover page without any numbering. You can achieve that with sections.
Sections are level nodes that control headers and footers, orientation, columns, margins, page number formatting, and others.
Aspose.Words allows you to manage sections, divide a document into sections, and make formatting changes that apply only to a specific section. Aspose.Words stores information about section formatting such as headers and footers, page setup, and column settings in the section break.
This article explains how to work with sections and section breaks.
What Section and Section Break Is
Document sections are represented by the Section and SectionCollection classes. Section objects are immediate children of the Document node and can be accessed via the Sections property. You can manage those nodes by using some methods such as Remove, Add, IndexOf, and others.
Section break is an option that divides document pages into sections with customizable layouts.
Types of a Section Break
Aspose.Words allows you to split and format documents using different section breaks of the BreakType enumeration:
You can also use the SectionStart enumeration to choose a break type that applies only for the first section such as NewColumn, NewPage, EvenPage, and OddPage.
Manage a Section
Since a section is a normal composite node, the entire node manipulation API can be used to manipulate sections: to add, remove, and other operations on sections. You can read more about nodes in the article “Aspose.Words Document Object Model (DOM)".
On the other hand, you can also use the DocumentBuilder API to work with sections. In this article, we will focus on this particular way of working with sections.
Insert or Remove a Section Break
Aspose.Words allows you to insert a section break into text using the InsertBreak method.
The following code example shows how to insert a section break into a document:
The following code example shows how to remove sections breaks:
Move a Section
If you want to move a section from one position to another in your document, you need to get the index of that section. Aspose.Words allows you to get a section position from a SectionCollection. You can use the Sections property to get all sections in your document. But if you want to get only the first section, you can use the FirstSection property.
The following code example shows how to access the first section and iterate through the children of a composite node:
Specify a Section Layout
Sometimes you want your document to look better by making creative layouts for different document sections. If you want to specify the type of the current section grid, you can choose a section layout mode using the SectionLayoutMode enumeration:
The following code example shows how to limit the number of lines that each page may have:
Edit a Section
When you add a new section to your document, there will be no body or paragraph that you can edit. Aspose.Words allows you to guarantee that a section contains a body with at least one paragraph using the EnsureMinimum method – it will automatically add a Body (or HeaderFooter) node to the document and then add a Paragraph to it.
The following code example shows how to prepare a new section node using EnsureMinimum:
Append or Prepend Content
The following code example shows how to append content of an existing section:
Clone a Section
Aspose.Words allows you to duplicate a section by creating a full copy of it using the Clone method.
The following code example shows how to clone the first section in your document:
Copy Sections between Documents
In some cases, you may have large documents with many sections and you want to copy the content of a section from one document to another.
Aspose.Words allows you to copy sections between documents using the ImportNode method.
The following code example shows how to copy sections between documents:
Work with Section Header and Footer
The basic rules for displaying a header or footer for each section are quite simple:
- If the section does not have its own headers/footers of a certain type, then it is taken from the previous section.
- The type of header/footer displayed on the page is controlled by the “Different First Page” and “Different Odd & Even pages” section settings – if they are disabled, then the section’s own titles are ignored.
The following code example shows how to create 2 sections with different headers:
If you want to remove the text of headers and footers without removing HeaderFooter objects in your document, you can use the ClearHeadersFooters method. In addition, you can use the DeleteHeaderFooterShapes method to remove all shapes from headers and footers in your document.
The following code example shows how to clear content of all headers and footers in a section:
The following code example how to remove all shapes from all headers footers in a section:
Customize Page Properties in a Section
Before printing a page or a document you may want to customize and modify the size and layout of a single page or the whole document. With page setup, you can change the settings of document pages such as margins, orientation, and size for printing different first pages or odd pages.
Aspose.Words allows you to customize page and section properties using the PageSetup class.
The following code example shows how to set such properties as page size and orientation for the current section:
The following code example shows how to modify the page properties in all sections: