VERIFICATIONCALLBACK Function

#include "ltdoc.h"

L_INT pEXT_FUNCTION YourFunction(nZoneIndex, pszWord, pVerify, pUserData)

L_INT nZoneIndex;

/* zone index */

L_TCHAR L_FAR * pszWord;

/* string contains suggested word */

VERIFYCODE * pVerify;

/* pointer to be updated */

L_VOID L_FAR * pUserData;

/* pointer to additional parameters */

Reports the suggested word for the last recognized word in a specific zone.

Parameter

Description

nZoneIndex

Specifies the index of the zone that contains the recognized word.

pszWord

Character string that contains the suggested word for the recognized word.

pVerify

Pointer to be updated with user verification answer for the suggested word.

pUserData

A void pointer that you can use to access a variable or structure containing data that your callback function needs. This gives you a way to receive data indirectly from the function that uses this callback function. (This is the same pointer that you pass in the pUserData member of ZONEDATA structure.)

 

Keep in mind that this is a void pointer, which must be cast to the appropriate data type within your callback function.

Returns

SUCCESS

The function was successful.

< 1

An error occurred. Refer to Return Codes.

Comments

This callback reports the suggested word of the recognized word in a zone.

This callback will be called during the recognition process.

To enable this callback, call L_DocAddZone or L_DocUpdateZone, and pass your callback function in the pfnCallback member of the ZONEDATA structure.

When calling L_DocRecognize, set the bEnableSubSystem and bEnableCorrection members of the RECOGNIZEOPTS structures to TRUE.

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_DocAddZone, L_DocGetZoneCount, L_DocGetZone, L_DocUpdateZone, L_DocRemoveZone, L_DocImportZones, L_DocExportZones, L_DocFindZones, L_DocSetZoneOptions, L_DocGetZoneOptions

Topics:

OCR Functions: Callbacks

Example

For an Example, refer to L_DocAddZone.