add method

This method inserts a new sections into the text document.

Defined in

TextSections

Syntax

public TextSection  add(String name, TextRange Position, int count) throws SymphonyException
public TextSection  add(String name, TextRange Position) throws SymphonyException

Parameters

String name

Specifies the name of the section. If the name already exists in another section, a default name is generated for the section. The default name is the string "Section" with a index suffix. For example, "Section1".

TextRange Position

Specifies the position before which the new section is to be inserted. Sections can be inserted only before the range of paragraphs, cells, and sections, otherwise this method throws an exception.

int count

Specifies how many columns the new section contains. The default value is 1. The maximum column count of a section is 99. If the value of this parameter is larger than 99 or smaller than 1, this method throws an exception.

Return Value

section

A TextSection object that represents a section.

See examples

Example: add method