AddNew Method of the TableSeparators Object

AddNew method of the TableSeparators Object in the ABBYY FineReader Engine API — Creates a new TableSeparator at the specified position and adds it to the collection.

This method creates a new TableSeparator object in the specified position and adds it into the collection.

Syntax

C++

HRESULT AddNew(
  int               Position,
  ITableSeparator** Result
);

C#

ITableSeparator AddNew( int Position );

Visual Basic .NET

Function AddNew(Position As Integer) As ITableSeparator

Parameters

Position

[in] This parameter specifies the position of the table separator on the image on which the Layout is defined, particularly on its deskewed black-and-white image plane. If the TableSeparators object represents vertical separators, this is horizontal coordinate, and vertical coordinate otherwise.

Result

[out, retval] A variable of type ITableSeparator* that receives a pointer to the interface of the TableSeparator object which represents the newly added table separator.

Return values

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

Remarks

Position of the newly added separator should lay between borders of the table block and should not coincide with an existing table separator; otherwise, an error code is returned. Adding of the table separator into a table changes table cells (TableCells object), as new cells may appear as the result of such operation. If the table separator splits table cell that contain recognized text, this text remains in one of the resulting cells (top or left, depending on the split direction).

See also

TableSeparators