L_Doc2GetZoneLayoutExt

#include "ltdoc2.h"

L_LTDOC2_API L_INT L_Doc2GetZoneLayoutExt(hDoc, nDocId, nPageIndex, nZoneIndex, pprc, pnRectCount)

Gets the zone layout.

Parameters

L_HDOC2 hDoc

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

L_INT nDocId

Document ID created by calling L_Doc2CreateDocument.

L_INT nPageIndex

Zero-based index of the page.

L_INT nZoneIndex

Zero-based index of the zone.

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 L_Doc2GetZoneLayoutExt 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, passing NULL to pprc to get the element count of the rectangle array.
2. Allocate an array of RECT structures.
3. Call L_Doc2GetZoneLayoutExt a second time, 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.