TableCells Object (ITableCells Interface)

TableCells object (ITableCells interface) in the ABBYY FineReader Engine API — Collection of TableCell objects for a table block; provides standard collection functionality plus Merge, Split, and IndexOf-by-grid-position.

All cells of a table block form a single collection represented by TableCells object. Besides the standard collection functionality, this object contains methods for merging and splitting groups of table cells and method for finding table cell index in collection by its position in a base table grid. The collection is accessible via the TableBlock object.

• The indexing of ABBYY FineReader Engine collections starts with 0.
• The foreach statement in C# (for each in Visual Basic .NET) can be used to manipulate the collection.

Properties

Name	Type	Description
Application	Engine, read-only	Returns the Engine object.
Count	int, read-only	Stores the number of elements in the collection.
Element	TableCell, read-only	Provides access to a single element of the collection.

Methods

Name	Description
IndexOf	Returns an index of the cell that corresponds to the specified point in base coordinates. This method may be useful if you want to obtain indices of all cells from one row or column.
Item	Provides access to a single element of the collection.
Merge	Merges a group of cells inside the specified rectangle.
Split	Splits a group of cells inside the specified rectangle.

Related objects

Object Diagram

Samples

C# code

FREngine.IBlock block;
// Retrieving table cells
if (block.Type == FREngine.BlockTypeEnum.BT_Table)
{
 FREngine.ITableBlock tableBlock = block.GetAsTableBlock();
 for( int iCell = 0; iCell < tableBlock.Cells.Count; iCell++ ) {
  FREngine.ITableCell cell = tableBlock.Cells[iCell];
  // do something with the cell
 }
}

The object is used in the following code samples:

Windows: RecognizedTextProcessing; and demo tools: Engine Predefined Processing Profiles.

See also

TableBlock

TableCell

Working with Layout and Blocks

Working with Text

Working with Collections

Working with Properties