TXTextControl.SectionCollection.Add Method

Adds a new section to a document.

Add(SectionBreakKind)

Adds a new section at the current text input position. The new section ends at the end position of the section containing the input position. If a new section is inserted in a paragraph or table, the paragraph or table is split into two paragraphs or tables.

[C#]
public bool Add(SectionBreakKind sectionBreakKind);
[Visual Basic]
Public Function Add(ByVal sectionBreakKind As SectionBreakKind) As Boolean
Parameter Description
sectionBreakKind

Specifies the kind of the section break. It can be one of the SectionBreakKind values. The following values are possible:


Value Meaning
BeginAtNewLine The section begins on the next line with a new paragraph.
BeginAtNewPage The section begins on the next page with a new paragraph.

Add(SectionBreakKind, Int32)

Adds a new section at the specified text input position. The new section ends at the end position of the section containing the input position. If a new section is inserted in a paragraph or table, the paragraph or table is split into two paragraphs or tables.

[C#]
public bool Add(SectionBreakKind sectionBreakKind, int textPosition);
[Visual Basic]
Public Function Add(ByVal sectionBreakKind As SectionBreakKind, ByVal textPosition As Integer) As Boolean
Parameter Description
sectionBreakKind

Specifies the kind of the section break. It can be one of the SectionBreakKind values. The following values are possible:


Value Meaning
BeginAtNewLine The section begins on the next line with a new paragraph.
BeginAtNewPage The section begins on the next page with a new paragraph.
textPosition

Specifies the text position at which the section is to be inserted.

Return Value

The return value is true, if the section could be added. Otherwise it is false.

See Also