GetAlphabetHRC
2.0
Retrieves the
alphabet being used in a handwriting recognition context HRC.
int GetAlphabetHRC( HRC hrc, LPALC lpalc,
LPBYTE rgbfAlc )
Parameters
hrc
Handle to the
HRC object.
lpalc
Address of a
buffer that receives the current ALC_ values. If NULL, this parameter is
ignored.
rgbfAlc
Address of an
array of bits or NULL. If NULL, this parameter is ignored. If lpalc
contains ALC_USEBITMAP and rgbfAlc points to a valid array, the array is
filled according to the bits set by the SetAlphabetHRC function.
Return Value
Returns
HRCR_OK if successful; otherwise, returns one of the following negative values:
|
Constant |
Description |
|
HRCR_ERROR |
Invalid
parameter or other error. |
|
HRCR_MEMERR |
Insufficient
memory. |
|
HRCR_UNSUPPORTED |
The
recognizer does not support this function. |
Comments
If rgbfAlc
is not NULL, the array it points to must be large enough to accommodate 256
bits (32 bytes). If the nth bit is set, the nth ANSI character is
recognizable. Bits representing characters with ASCII values less than 32 (the
space character) currently have no meaning.
ALC_DEFAULT
specifies the set of characters at or above ALC_SYSMINIMUM that the recognizer
can accurately distinguish.
For a
description of alphabets and their relationship to a recognizer, see
Configuring the HRC in Chapter 5, The Recognition Process.
See Also