HwxALCValid (Windows Embedded CE 6.0)
1/6/2010
This function defines the set of characters that the character recognition engine can return when it converts ink, which is user-drawn input, to a text string.
Syntax
BOOL HwxALCValid(
HRC hrc,
ALC alc
);
Parameters
- hrc
[in] Handle to the handwriting recognition context (HRC) object.
alc
[in] Alphabet code (ALC) value that describes the character groupings used by the recognizer to evaluate the input handwriting. The following table shows the values this parameter can take.Value Description ALC_WHITE
Used for a blank or white space.
ALC_LCALPHA
Used for the lowercase alphabet, a through z.
ALC_UCALPHA
Used for the uppercase alphabet, A through Z.
ALC_NUMERIC
Used for the digits 0 through 9.
ALC_PUNC
Used for the set of standard punctuation. It is language-dependent.
ALC_NUMERIC_PUNC
Used for all non-digit characters in numbers, such as the period and the comma.
ALC_MATH
Used for a set of math symbols, such as %, ^, *, (), _, +, {}, <, and /.
ALC_MONETARY
Used for punctuation that appears in local monetary expressions.
ALC_COMMON_SYMBOLS
Signifies commonly used symbols from ALC_WHITE, ALC_LCALPHA, ALC_UCALPHA, ALC_NUMERIC, ALC_PUNC, ALC_NUMERIC_PUNC, ALC_MATH, and ALC_MONETARY.
ALC_OTHER
Signifies other punctuation that is not typically used.
ALC_ASCII
Used for the 7-bit ASCII characters — 20 through 7F.
ALC_HIRAGANA
Used for Hiragana characters.
ALC_KATAKANA
Used for Katakana characters.
ALC_KANJI_COMMON
Used for the most commonly used Kanji characters (JPN).
ALC_KANJI_RARE
Used for the remaining Kanji characters (JPN).
ALC_HANGUL_COMMON
Signifies the commonly used Hangul characters used in Korea.
ALC_HANGUL_RARE
Signifies the remaining Hangul characters used in Korea.
ALC_OEM
Specific to recognizers created by OEMs.
ALC groupings created by combining two or more related ALC basic values are described in the following table.
ALC groupings Basic ALC values ALC_ALPHA
ALC_LCALPHA | ALC_UCALPHA
ALC_ALPHANUMERIC
ALC_ALPHA | ALC_NUMERIC
ALC_KANA
ALC_HIRAGANA | ALC_KATAKANA
ALC_KANJI_ALL
ALC_KANJI_COMMON | ALC_KANJI_RARE
ALC_HANGUL_ALL
ALC_HANGUL_COMMON | ALC_HANGUL_RARE
ALC_EXTENDED_SYM
ALC_MATH | ALC_MONETARY | ALC_OTHER
ALC_SYS_MINIMUM
ALC_ALPHANUMERIC | ALC_PUNC | ALC_WHITE
ALC_SYS_DEFAULT
ALC_SYS_MINIMUM | ALC_COMMON_SYMBOLS
The following table shows how these groupings can be combined with each other or with the basic values for various languages.
Language ALC groupings ALC groupings ALC_USA_COMMON
ALC_SYS_DEFAULT
ALC_USA_EXTENDED
ALC_USA_COMMON | ALC_EXTENDED_SYM
ALC_JPN_COMMON
ALC_SYS_DEFAULT | ALC_KANA | ALC_KANJI_COMMON
ALC_JPN_EXTENDED
ALC_JPN_COMMON | ALC_EXTENDED_SYM | ALC_KANJI_RARE
ALC_CHS_COMMON
ALC_SYS_DEFAULT | ALC_KANJI_COMMON
ALC_CHS_EXTENDED
ALC_CHS_COMMON | ALC_EXTENDED_SYM | ALC_KANJI_RARE
ALC_CHT_COMMON
ALC_SYS_DEFAULT | ALC_KANJI_COMMON
ALC_CHT_EXTENDED
ALC_CHT_COMMON | ALC_EXTENDED_SYM | ALC_KANJI_RARE
ALC_KOR_COMMON
ALC_SYS_DEFAULT | ALC_HANGUL_COMMON | ALC_KANJI_COMMON
ALC_KOR_EXTENDED
ALC_KOR_COMMON | ALC_EXTENDED_SYM | ALC_HANGUL_RARE | ALC_KANJI_RARE
Return Value
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.
Remarks
This function lets an application restrict or expand the amount of characters that the recognition engine uses when it translates user-drawn characters. For example, if an application is expecting a telephone number as input from a user, the application can call HwxALCValid to specify the ALC_NUMERIC character range. Specifying a limited character range prevents the recognition engine from interpreting a user-drawn zero as an uppercase O.
When HwxALCValid specifies multiple ALCs, an application can use the HwxALCPriority function to indicate the first ALC to use during the handwriting recognition process.
HwxALCValid fails when a specified ALC is not loaded on the device.
Requirements
| Header | recog.h |
| Library | hwxcht.lib, Hwxjpn.lib, Hwxkor.lib, hwxusa.lib |
| Windows Embedded CE | Windows CE .NET 4.0 and later |