L_Doc2SelectZoneByPoint

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2SelectZoneByPoint(hDoc, hDC, nPageIndex, pt, pnZoneIndex)

L_HDOC2 hDoc;	/* handle to the OCR document */
HDC hDC;	/* handle to the target device context */
L_INT nPageIndex;	/* page index */
POINT pt;	/* specifies the point */
L_INT * pnZoneIndex;	/* pointer to be updated */

Draws a selection rectangle around the zone located at the specified point.

Parameter	Description
hDoc	Handle to the OCR document.
hDC	Handle to a device context, such as a screen, to use as the display surface. The mapping mode of the device context must be MM_TEXT.
nPageIndex	Index of the page that contains the zones. This index is zero-based.
pt	The X and Y coordinates for a point inside a zone.
pnZoneIndex	Pointer to a variable to be updated with the index of the selected zone.

Returns

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

Comments

Draws a selection rectangle around the zone that contains the specified point.

This function will return the selected zone index if it finds a zone that contains the specified point.

To draw a page, call the L_Doc2DrawPage 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_Doc2LockPage, L_Doc2UnlockPage, L_Doc2SetActivePage, L_Doc2DrawPage, L_Doc2SelectZone, L_Doc2RemoveSelectedZone, L_Doc2SetZonePen, L_Doc2SetSelectedZonePen, L_Doc2GetSelectedZone, L_Doc2Zone
Topics:	OCR Functions: Drawing Zones and Pages
	Drawing Pages and Zones

Example

L_LTDOC2TEX_API  L_INT Doc2SelectZoneByPointExample(L_HDOC2 hDoc, HWND hWnd)
{
   L_INT nRet;
   HDC hdc = GetDC(hWnd);
   L_INT nSelZone = 0;
   POINT pt;
   pt.x = 450;
   pt.y = 400;

   nRet = L_Doc2SelectZoneByPoint(hDoc, hdc, 0, pt, &nSelZone);
   if (nRet == SUCCESS)
   {
      L_TCHAR szBuffer[200];
      ZeroMemory(szBuffer, sizeof(szBuffer));

      wsprintf(szBuffer, TEXT("The selected zone index = %d\n"), nSelZone);
      MessageBox(NULL, szBuffer, TEXT("Notice!"), MB_OK);
   }
   else 
      return nRet;

   ReleaseDC(hWnd, hdc);
   return SUCCESS;
}