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