L_DocSelectZone

#include "ltdoc.h"

L_LTDOC_API L_INT L_DocSelectZone(hDoc, hDC, nPageIndex, nZoneIndex, bSelect)

L_HDOC hDoc;

/* handle to the OCR document */

L_HDC hDC;

/* handle to the target device context */

L_INT nPageIndex;

/* page index */

L_INT nZoneIndex;

/* zone index */

L_BOOL bSelect;

/* flag to select or deselect */

Selects or deselects the specified zone and draws it in the specified hDC.

Parameter

Description

hDoc

Handle to the OCR document.

hDC

Handle to a device context, such as a screen, to use as the display surface. The mapping mode of the device context must be MM_TEXT.

nPageIndex

Specifies the index of the page which contains the zone.This index is zero-based.

nZoneIndex

Specifies the index of the zone that will be selected or deselected. This index is zero-based.

bSelect

Flag which determines the function behavior. Valid values are:

 

Value

Meaning

 

TRUE

Select the specified zone by nZoneIndex parameter.

 

FALSE

Deselect the specified zone by nZoneIndex parameter.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

Selects or deselects the specified zone in the specified page and draws the results into the device context (L_HDC).

To draw a page, call L_DocDrawPage.

To select a zone by specifying a hit point, call L_DocSelectZoneByPoint.

Required DLLs and Libraries

LTDOC

For a listing of the exact DLLs and Libraries needed, based on the toolkit version, refer to Files To Be Included With Your Application.

See Also

Functions:

L_DocLockPage, L_DocUnlockPage, L_DocSetActivePage, L_DocDrawPage, L_DocSelectZoneByPoint, L_DocRemoveSelectedZone, L_DocSetZonePen, L_DocSetSelectedZonePen, L_DocGetSelectedZone, L_DocZone

Topics:

OCR Functions: Drawing Zones and Pages

 

Drawing Pages and Zones

Example

For an example, refer to L_DocDrawPage.