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;
}