Merge Method of the TableCells Object

Merge method of the TableCells Object in the ABBYY FineReader Engine API — Merges the group of cells located in the specified rectangle; recognized text in those cells is concatenated and assigned to the new merged cell.

This method merges a group of cells located in the specified rectangle. This method changes the TableCells object — it affects the number of cells. During the merge, recognized text in cells, if any, is also merged and assigned to the newly created cell.

Syntax

C++

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

C#

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

Visual Basic .NET

Sub Merge( _
  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 merge is specified in base coordinates, not on image. It should not cut existing cells. This means that if table block already 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.

See also

ITableCells::Split