ZONEDATA2

Show in webframe

typedef struct _tagZoneData2
{
   L_UINT uStructSize;
   RECT rcArea;
   DOC2_FILLMETHOD FillMethod;
   DOC2_RECOGMODULE RecogModule;
   DOC2_CHAR_FILTER CharFilter;
   DOC2_ZONETYPE Type;
   L_UINT uFlags;
   L_CHAR szSection[DOC2_MAX_SECTION_NAME_LENGTH];
   VERIFICATIONCALLBACK2 pfnCallback;
   L_VOID * pUserData;
} ZONEDATA2, * pZONEDATA2;

The ZONEDATA2 structure provides zone information. This structure contains all the information necessary to describe a zone. A zone is a rectangular area on an image containing a feature of interest to the user. The image data covered by each zone is handled and processed (typically recognized) separately.

Member	Description
uStructSize	Structure size. It should be equal to sizeof(ZONEDATA2).
rcArea	Coordinates of the zone (RECT)
FillMethod	Zone filling method. For a list of possible values, refer to DOC2_FILLMETHOD.
RecogModule	Recognition module associated with the zone. For a list of possible values, refer to DOC2_RECOGMODULE.
CharFilter	Character Set filter for the zone. For a list of possible values, refer to DOC2_CHAR_FILTER.
Type	Zone type. For a list of possible values, refer to DOC2_ZONETYPE.
uFlags	Flags that control the checking process. These values can be combined using OR (\|). Possible values are:
	Value	Meaning
	DOC2_ZONE_CHK_LANGDICT_PROHIBIT	[0x00000001] Prohibit the use of the Language dictionary.
	DOC2_ZONE_CHK_USERDICT_PROHIBIT	[0x00000002] Prohibit the use of the User dictionary.
	DOC2_ZONE_CHK_CHECKCBF_PROHIBIT	[0x00000004] Prohibit the use of the user-written checking callback function.
	DOC2_ZONE_CHK_VERTDICT_PROHIBIT	[0x00000008] Prohibit the use of the Vertical dictionary.
	DOC2_ZONE_CHK_IGNORE_WHITESPACE	[0x00000010] Ignore white space characters (SPACE and TAB characters) during checking. This field should be used together with the DOC2_ZONE_CHK_PASS_LINES flag.
	DOC2_ZONE_CHK_IGNORE_CASE	[0x00000020] Ignore case when checking with the User Dictionary.
	DOC2_ZONE_CHK_PASS_LINES	[0x00000040] Have the RECOGMODULE pass entire lines to the checker, instead of words. Do not use this attribute in conjunction with spell checking.
	DOC2_ZONE_CHK_CORRECTION_DISABLED	[0x00000080] Disable Spell checking even if it is enabled at page-level
	DOC2_ZONE_CHK_INCLUDE_PUNCTUATION	[0x00000100] Consider punctuation characters on the boundaries of the strings, as well.
	DOC2_ZONE_CHK_CORRECT_PROPERNAMES	[0x00000200] Enable the correcting of words beginning with an uppercase letter inside a sentence (i.e. typically but not always proper names)
	DOC2_ZONE_CHK_LANGDICT_USED	[0x00010000] "After recognition flag": the Language dictionary was enabled during the checking process (spell checking was activated for the zone)
	DOC2_ZONE_CHK_USERDICT_USED	[0x00020000] "After recognition flag": the User dictionary was enabled during the checking process (UD-checking was activated for the zone).
	DOC2_ZONE_CHK_CHECKCBF_USED	[0x00040000] "After recognition flag": a user-written checking callback function was enabled during the checking process (user-written checking was activated)
szSection	Contains a null terminated string (for instance, the section name in the User dictionary is assigned to the zone or an empty string)
pfnCallback	Address of a user-written verification callback function (VERIFICATIONCALLBACK2 function) or NULL.
pUserData	More user data used in pUserData parameter of the VERIFICATIONCALLBACK2 function

Comments

This structure contains all of the information necessary to describe the bounding box for a zone.

A pizzabox shape is a union of rectangles, where the top of each rectangle in the union must touch the bottom of the rectangle above it. A rectangle can touch at most one rectangle above and one below. The following zones cannot have a pizzabox shape:

Table zones (must be rectangular)

Zones in an image are built into a sequential list, called the zone list. Each zone receives an internal index number, reflecting its position in this list. In some cases this zone order even determines the zone content order in the final output document. The index of the first zone in the zone list is zero (0).

pZONEDATA2 is a pointer to a ZONEDATA2 structure. If the function parameter type is pZONEDATA2, declare a ZONEDATA2 variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pZONEDATA2 variable is necessary only if the program requires a pointer.