HwxALCPriority
This function is called by an application to specify which alphabet code (ALC) values the handwriting recognition engine returns first.
BOOL HwxALCPriority (
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 prioritize the results of the recognition analysis. It can be one or more of the following values: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_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. ALC_KANJI_RARE Used for the remaining Kanji characters. 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 |
These groupings can be combined with each other or with the basic values for various languages, as described in the following table.
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 Values
TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.
Remarks
The handwriting recognition engine matches user-drawn characters, or ink, to characters contained in ALCs. The engine then returns these possible matches in a list ordered from most likely match to least likely match. When the HwxALCValid function specifies multiple ALCs, an application can use HwxALCPriority to indicate which ALC has priority in the list of possible matches. For example, specifying ALC_SYS_MINIMUM with a call to HwxALCValid means that the handwriting recognition engine uses three ALCs: ALC_ALPHANUMERIC, ALC_PUNC, and ALC_WHITE. If a user draws a lowercase j and a call to HwxPriority gives ALC_ALPHANUMERIC priority, j is likely to returned as the best possible match. But, if ALC_PUNC—punctuation symbols—has priority, the semi-colon might be listed before j in the list of possible matches.
Requirements
Runs on | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.0 and later | Recog.h | Hwxjpn.lib, Hwxusa.lib |
Note This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.
See Also
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.