SplitCells Method

void SplitCells( 
   int zoneIndex,
   bool vertical,
   LogicalRectangle bounds,
   LogicalPoint splitterPosition,
   LogicalLength splitterWidth,
   OcrCellBorderLineStyle splitterStyle,
   RasterColor splitterColor
)

'Declaration
 
Sub SplitCells( _
   ByVal zoneIndex As Integer, _
   ByVal vertical As Boolean, _
   ByVal bounds As LogicalRectangle, _
   ByVal splitterPosition As LogicalPoint, _
   ByVal splitterWidth As LogicalLength, _
   ByVal splitterStyle As OcrCellBorderLineStyle, _
   ByVal splitterColor As RasterColor _
) 

'Usage
 
Dim instance As IOcrTableZoneManager
Dim zoneIndex As Integer
Dim vertical As Boolean
Dim bounds As LogicalRectangle
Dim splitterPosition As LogicalPoint
Dim splitterWidth As LogicalLength
Dim splitterStyle As OcrCellBorderLineStyle
Dim splitterColor As RasterColor
 
instance.SplitCells(zoneIndex, vertical, bounds, splitterPosition, splitterWidth, splitterStyle, splitterColor)

void SplitCells( 
   int zoneIndex,
   bool vertical,
   LogicalRectangle bounds,
   LogicalPoint splitterPosition,
   LogicalLength splitterWidth,
   OcrCellBorderLineStyle splitterStyle,
   RasterColor splitterColor
)

function Leadtools.Forms.Ocr.IOcrTableZoneManager.SplitCells( 
   zoneIndex ,
   vertical ,
   bounds ,
   splitterPosition ,
   splitterWidth ,
   splitterStyle ,
   splitterColor 
)

void SplitCells( 
   int zoneIndex,
   bool vertical,
   LogicalRectangle bounds,
   LogicalPoint splitterPosition,
   LogicalLength splitterWidth,
   OcrCellBorderLineStyle splitterStyle,
   RasterColor splitterColor
) 

Parameters

zoneIndex

The 0-based index of the zone inside this page IOcrPage.Zones. This zone must exist in the list and its type must be a table (OcrZone.ZoneType must be OcrZoneType.Table) otherwise, this method will throw an exception.

vertical

Split direction, if true means split vertically, otherwise; split horizontally.

bounds

The cells intersected or contained by this area are selected for this method.

splitterPosition

The position of the splitter.

splitterWidth

The width of the splitter.

splitterStyle

The style of the splitter.

splitterColor

The color of the splitter line.

Manipulating cells position and size inside a table zone is a very sensitive matter and any non-accurate information will cause an error. The IOcrTableZoneManager contains methods to easily accomplish these tasks with minimum error. These methods are built around what is expected to be accomplished by an application that manipulates the cells of a zone through a user-interface, such as clicking and dragging with the mouse.

The following methods can be used to manipulate the cells position and size:

• SplitCells and merge cells to split/merge the cells inside a given area in a table zone. This makes it easy to add/remove cells to the zone.

• GetPointInformation to Gets the cell index and the nearest border for a given point. This can be used by selecting a cell or a border using a mouse click.

• MoveCellBorder and GetCellBorderDragLimit to move a cell border while making sure it does not get run over adjuscent cells or the table area. This can be used to change the size of a cell by clicking and dragging the mouse.

• GetTabulatorPosition to get the tabulator position. The tabulator has only a horizontal position.

• GetHorizontalSplitters and GetVerticalSplitters to get the number and positions of horizontal and vertical splitters. You can these methods to draw splitter guidelines in your user interface, or change the mouse cursor to a different shape if it is located over a splitter and dragging is allowed.

Target Platforms: Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

Reference

IOcrTableZoneManager Interface
IOcrTableZoneManager Members