typedef struct _tagRecogChars2
} RECOGCHARS2, * pRECOGCHARS2;
The RECOGCHARS2 structure provides information about the recognized characters.
Structure size. Set it to sizeof(RECOGCHARS2).
RECT structure containing the area for the recognized character.
Y coordinate of the baseline, measured from the top edge of the rectangle exactly containing the character.
Index of the zone in the zone list that contains the character.
Index of the cell in the cell list containing the character (applicable only for
DOC2_ZONE_TABLE zone type of DOC2_ZONETYPE ). The cell list is not accessible for the application.
Confidence number expressing both the certainty of the recognition of the first guess (code member) and also the certainty of the word. Valid values for nConfidence range from 0 to 100.
Font information about the recognized character. Values can be combined using OR (|). Possible values are:
|DOC2_FONT_ITALIC||[0x001] The character is italic.|
|DOC2_FONT_BOLD||[0x002] The character is bold.|
|DOC2_FONT_UNDERLINE||[0x004] The character is underlined.|
|DOC2_FONT_SUBSCRIPT||[0x008] The character is subscript.|
|DOC2_FONT_SUPERSCRIPT||[0x010] The character is superscript.|
|DOC2_FONT_SANSSERIF||[0x020] The character is Sans Serif.|
|DOC2_FONT_SERIF||[0x040] The character is Serif.|
|DOC2_FONT_PROPORTIONAL||[0x080] The character is proportional.|
|DOC2_FONT_SMALLCAPS||[0x0100] The character is a Small Caps character|
|DOC2_FONT_DROPCAP||[0x0200] The character is a Dropcap character.|
|DOC2_FONT_POPCAP||[0x0400] The character is a Popcap character.|
|DOC2_FONT_INVERTED||[0x1000] The character is an Inverted character.|
Font size in points.
Formatting attributes of the character. Values can be combined using OR (|). Possible values are:
|DOC2_CHAR_ENDOFLINE||[0x001] This is the last character in a line.|
|DOC2_CHAR_ENDOFPARA||[0x002] This is the last character in a paragraph.|
|DOC2_CHAR_ENDOFWORD||[0x004] This is the last character of a word.|
|DOC2_CHAR_ENDOFZONE||[0x008] This is the last character in a zone.|
|DOC2_CHAR_ENDOFPAGE||[0x010] This is the last character on a page.|
|DOC2_CHAR_ENDOFCELL||[0x020] This is the last character in a cell. (applicable only for
|DOC2_CHAR_ENDOFROW||[0x040] This is the end of the last line of the last filled cell of a table row.|
|DOC2_CHAR_INTABLE||[0x080] The character is in a table cell.|
Value that represents the first language in which the recognized word is found. For a list of possible values, refer to DOC2_LANGIDS.
Value that represents the second language in which the recognized word is found.
The capital letter height in pixels.
Width of a dot in pixels if the "underline" is under dots in reality. 0 if simple underline, 0 if nothing.
Width of a gap in pixels if the "underline" is under dots in reality. 0 if simple underline, 0 if nothing.
Index of the foreground color within the palette of the recognition data.
Index of the background color within the palette of the recognition data.
The application should evaluate the nConfidence member when confidence information on the recognition is also required. The nConfidence value represents the certainty of the character recognition and ranges between 0 and 100. The larger the nConfidence value is, the higher the confidence of the recognition. For more details, see the Confidence reporting topic.
pRECOGCHARS2 is a pointer to a RECOGCHARS2 structure. If the function parameter type is pRECOGCHARS2, declare a RECOGCHARS2 variable, update the structure's fields, and pass the variable's address in the parameter. Declaring a pRECOGCHARS2 variable is necessary only if the program requires a pointer.
If the recognition process cannot associate the current recognized word with any language, then Lang is updated with the
DOC2_LANG_ID_NO member of DOC2_LANGIDS.
If the recognized word can be found in more than one language, then Lang will be updated with the ID of the first language in which the recognized word was found, and Lang2 will be updated with the second language in which the word was found.
The structure is used by: