AddNew Method of the TableSeparators Object
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
17.09.2024 15:14:41