L_Doc2GetZoneLayout

#include "ltdoc2.h"

L_LTDOC2_API L_INT EXT_FUNCTION L_Doc2GetZoneLayout(hDoc, nPageIndex, nZoneIndex, pprc, pnRectCount)

Gets user zone shape rectangles.

Parameters

L_HDOC2 hDoc

Handle to the OCR document. This handle is obtained by calling the L_Doc2StartUp function.

L_INT nPageIndex

Index of the page. This is a zero-based index.

L_INT nZoneIndex

Index of the zone. This is a zero-based index.

RECT ** pprc

Address of an array of RECT structures to be updated.

L_INT * pnRectCount

Address of a variable to be updated with the number of array elements.

Returns

Comments

Use this function to obtain information about the shape of a specific zone in the user zone list of the specified page.

To use the function properly:

1. Call it with passing NULL to pprc to get the element count of the rectangle array.
2. Allocate an array of RECT structures.
3. Call this it a second time with passing the address of the allocated array to the pprc parameter to obtain the shape of the zone in terms of rectangles.

To set zone rectangles call the L_Doc2SetZoneLayout / L_Doc2SetZoneLayoutExt function.

To add a user zone, call the L_Doc2AddZone / L_Doc2AddZoneExt function. To add rectangle(s) to a user zone to make its shape irregular, call the L_Doc2AddZoneRect / L_Doc2AddZoneRectExt 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.