TX Text Control .NET Server

Split Method

Method|Introduced in 11.0
Namespace
TXTextControl
Package
TXTextControl.TextControl.Core.SDK as TXTextControl.Core.dll from the private NuGet feed or Text Control Offline Packages
Also in
TXTextControl.TextControl.ASP.SDK as TXTextControl.dll

Description

Splits a table below or above the current input position. If the table does not contain the current input position it cannot be split. The Table.CanSplit property can be used to determine if a table can be split or not. If a table is split above the first row a new line is inserted above the table and if a table is split below the last row a new line is inserted below the table. This is useful to insert text above or below a nested table that immediately starts and/or ends at the beginning or the end of the cell in which it is nested.

Syntax

public bool Split(TableAddPosition position);

Parameters

ParameterDescription
position

Specifies the position where to split the table. It can be one of the TableAddPosition values:

ValueMeaning
BeforeThe table is split in front of the row with the current input position.
AfterThe table is split behind the row with the current input position.

Return Value

The return value is true, if the table could be split. Otherwise it is false.

Examples

The following example splits a table after its second row.

textControl.Tables.Add(4, 3, 10);
Table table = textControl.Tables.GetItem(10);
textControl.InputPosition =
    new InputPosition(table.Cells.GetItem(2, 1).Start);

table.Split(TableAddPosition.After);