Section Class

Description

An object of the Section class represents a section of a document. Sections are numbered from the beginning to the end of the document beginning with 1. A document has at least one section. A section is a part of the document that specifies the page size, the page margins and the headers and footers. A section object can be obtained from the section collection available through the TextControl.Sections property.

Syntax

public class Section

Public Class Section

Examples

The following example shows how to use the SectionClass to insert a new section with a different header and page orientation than the previous one:

textControl1.HeadersAndFooters.Add(TXTextControl.HeaderFooterType.Header);
textControl1.Sections.Add(TXTextControl.SectionBreakKind.BeginAtNewPage);
textControl1.Sections[2].Format.Landscape = true;
textControl1.Sections[2].HeadersAndFooters.GetItem(TXTextControl.HeaderFooterType.Header).ConnectedToPrevious = false;
TXTextControl.Selection mySelection = new TXTextControl.Selection(0, -1);
mySelection.Text = "New Section";
textControl1.Sections[2].HeadersAndFooters.GetItem(TXTextControl.HeaderFooterType.Header).Selection = mySelection;

TextControl1.HeadersAndFooters.Add(TXTextControl.HeaderFooterType.Header)
TextControl1.Sections.Add(TXTextControl.SectionBreakKind.BeginAtNewPage)
TextControl1.Sections(2).Format.Landscape = True
TextControl1.Sections(2).HeadersAndFooters.GetItem(TXTextControl.HeaderFooterType.Header).ConnectedToPrevious = False
Dim MySelection = New TXTextControl.Selection(0, -1)
MySelection.Text = "New Section"
TextControl1.Sections(2).HeadersAndFooters.GetItem(TXTextControl.HeaderFooterType.Header).Selection = MySelection

The following example works with the first section of the current document. The created object is then available to the surrounding document workflow.

Section section = textControl.Sections[1];
Console.WriteLine("Section is ready for use.");

Dim section As Section = textControl.Sections(1)
Console.WriteLine("Section is ready for use.")

Members

Properties

Property	Description
Format	Gets or sets the section's formatting attributes. The property's value is an object of the type SectionFormat which defines the page size and the page margins.
HeadersAndFooters	Gets a collection of all headers and footers of the section. The property's value is an object of the type HeaderFooterCollection.
Length	Gets the number of characters in the section. The section break character is not included.
Number	Gets the section's number. The first section has the number 1.
Start	Gets the number (one-based) of the first character in the section.

Methods

Method	Description
Select	Selects the section. The section break characters bounding the section are not selected.