DTWAIN_SelectOCREngine
|
The DTWAIN_SelectOCREngine function allows the user to select an OCR engine from a list of supported OCR Engines.
DTWAIN_OCRENGINE DTWAIN_SelectOCREngine( );
Parameters None.
Return Values If successful, the return value is a non-zero DTWAIN_OCRENGINE handle. Otherwise NULL is returned.
Comments The DTWAIN_SelectOCREngine function displays the DTWAIN Select OCR Engine dialog box and returns a handle to the selected OCR Engine. If the user chooses 'Cancel' from the dialog, DTWAIN_SelectOCREngine returns NULL.
To determine if a NULL return value from DTWAIN_SelectOCREngine is due to the user cancelling the dialog or if there is another error, call DTWAIN_GetLastError and check if the value is non-zero (which means an error occurred). If DTWAIN_GetLastError returned 0, this means that the user canceled the dialog, which is perfectly valid for the user to do.
The DTWAIN_OCRENGINE return value is used for any other DTWAIN function that requires an OCR Engine handle.
Prerequisite Calls
Optional Prerequisite Calls None.
|