Split Method of the TableCells Object

Split method of the TableCells Object in the ABBYY FineReader Engine API — Splits any merged cells in the specified rectangle; recognized text is assigned to the left-top cell after the split.

This method splits any merged cells that are located in the specified rectangle. This method changes the TableCells object — it affects the number of cells. After the split, recognized text from the cells is assigned to the left top cell.

Syntax

C++

HRESULT Split(
  int Left,
  int Top,
  int Right,
  int Bottom
);

C#

void Split(
  int Left,
  int Top,
  int Right,
  int Bottom
);

Visual Basic .NET

Sub Split( _
  Left As Integer, _
  Top As Integer, _
  Right As Integer, _
  Bottom As Integer _
)

Parameters

Left

[in] This variable specifies coordinate of the left border of the rectangle in base coordinates.

Top

[in] This variable specifies coordinate of the top border of the rectangle in base coordinates.

Right

[in] This variable specifies coordinate of the right border of the rectangle in base coordinates.

Bottom

[in] This variable specifies coordinate of the bottom border of the rectangle in base coordinates.

Return values

This method has no specific return values. It returns the standard return values of ABBYY FineReader Engine functions.

Remarks

The rectangle for split is specified in base coordinates, not on image. It should not cut existing cells. This means that if table block contains merged cells — cells having dimensions more than one base unit, a user should take care and not to specify the rectangle that would intersect the interior of such cells. This rectangle may only be drawn at cells’ borders. After this method call a number of new cells is added in the collection instead of the split cells. These new cells have dimensions of one base unit.

See also

ITableCells::Merge