L_Doc2ImportZones

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2ImportZones(hDoc, nPageIndex, pszFileName)

L_HDOC2 hDoc;	/* handle to the OCR document */
L_INT nPageIndex;	/* page index */
L_TCHAR * pszFileName;	/* file name */

Imports the zone list from a zone file.

Parameter	Description
hDoc	Handle to the OCR document.
nPageIndex	Index of the page into which the settings will be loaded. This is a zero-based index.
pszFileName	Character string containing the name of the zone file that contains the zones to import.

Returns

SUCCESS	The function was successful.
< 1	An error occurred. Refer to Return Codes.

Comments

Imports the user zone list from a zone file into the specified page.

Calling this function removes any zone list already attached to the specified page.

To save the zone list to a file, call the L_Doc2ExportZones function.

Required DLLs and Libraries

LTDOC2

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_Doc2AddZone, L_Doc2GetZoneCount, L_Doc2GetZone, L_Doc2UpdateZone, L_Doc2RemoveZone, L_Doc2ExportZones, L_Doc2FindZones, L_Doc2SetZoneOptions, L_Doc2GetZoneOptions
Topics:	OCR Functions: Zones
	Working with Zones

Example

L_LTDOC2TEX_API  L_INT Doc2ImportZonesExample(L_HDOC2 hDoc,
                                            L_INT nPageIndex,
                                            L_TCHAR * pszZoneFile)
{
   L_INT nRet;
   nRet = L_Doc2ImportZones(hDoc, nPageIndex, pszZoneFile);
   if (nRet == SUCCESS)
      MessageBox(NULL, TEXT("Imports the zone file into the specified page."), TEXT("Notice!"), MB_OK);
   else
      return nRet;

   //...
   // work with zones...
   //...

   // exports page zone list to Zone file...
   nRet = L_Doc2ExportZones (hDoc, nPageIndex, pszZoneFile);
   if (nRet == SUCCESS)
      MessageBox(NULL, TEXT("Exports the zone list into a zone file."), TEXT("Notice!"), MB_OK);
   else
      return nRet;
   
   return SUCCESS;
}