> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Merge Method of the TableCells Object

This method merges a group of cells located in the specified rectangle. This method changes the [TableCells](/fine-reader/engine/api-reference/layout-related-objects/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++

```cpp theme={null}
HRESULT Merge(
  int Left,
  int Top,
  int Right,
  int Bottom
);
```

### C\#

```csharp theme={null}
void Merge(
  int Left,
  int Top,
  int Right,
  int Bottom
);
```

### Visual Basic .NET

```vb theme={null}
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](/fine-reader/engine/api-reference/return-codes).

## Remarks

The rectangle for merge is specified in [base coordinates](/fine-reader/engine/guided-tour/advanced-techniques/working-with-layout-and-blocks#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](/fine-reader/engine/api-reference/layout-related-objects/tablecells/split-method)