Collapse All Expand All

L_Doc2RemoveZone

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2RemoveZone(hDoc, nPageIndex, nZoneIndex)

L_HDOC2 hDoc;	/* handle to the OCR document */
L_INT nPageIndex;	/* page index */
L_INT nZoneIndex;	/* zone index */

Removes one or more zones from the zone list for the specified page.

Parameter	Description
hDoc	Handle to the OCR document.
nPageIndex	Index of the page for which the zone(s) will be deleted. This is a zero-based index.
nZoneIndex	Index of the zone(s) to be deleted. This is a zero-based index.

Returns

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

Comments

The nZoneIndex parameter specifies the zone that will be deleted. If you pass 1 for the nZoneIndex parameter, then this function will delete all zones in the zone list for the specified page.

The index of the first zone in the zone list is zero (0).

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_Doc2ImportZones, L_Doc2ExportZones, L_Doc2FindZones, L_Doc2SetZoneOptions, L_Doc2GetZoneOptions
Topics:	OCR Functions: Zones
	Working with Zones

Example

L_LTDOC2TEX_API  L_INT Doc2RemoveZoneExample(L_HDOC2 hDoc, L_INT nPageIndex, L_INT nZoneIndex)
{
   L_INT nRet;
   
   nRet = L_Doc2RemoveZone(hDoc, nPageIndex, nZoneIndex);
   if (nRet == SUCCESS)
      MessageBox(NULL, TEXT("The specified zone is deleted from the specified page."), TEXT("Notice!"), MB_OK);
   else
   {
      MessageBox(NULL, TEXT("The engine couldn't delete the specified zone."), TEXT("Error!"), MB_OK);
      return nRet;
   }
   return SUCCESS;
}