VERIFICATIONCALLBACK Function
#include "ltdoc.h"
L_INT pEXT_FUNCTION YourFunction(nZoneIndex, pszWord, pVerify, pUserData)
L_INT nZoneIndex; |
/* zone index */ |
/* string contains suggested word */ | |
VERIFYCODE * pVerify; |
/* pointer to be updated */ |
/* 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: |
Example
For an Example, refer to L_DocAddZone.