This function creates an handwriting recognition context (HRC) object. This object is used by a handwriting recognition engine to obtain ink—information that describes what the user is drawing—and to store the results of recognition processing.
At a Glance
| Header file: | Recog.h |
| Windows CE versions: | 2.0 and later |
Syntax
HRC HwxCreate( HRC hrc );
Parameters
hrc
[in] Handle to an existing handwriting recognition context (HRC) object that provides settings for the recognition context being created. If it is NULL, then default settings are used.
Return Values
The handle to the newly created HRC object indicates success. NULL indicates failure. To get extended error information, call GetLastError.
Remarks
To efficiently process handwriting, create a master HRC before collecting any ink. This master HRC is a template that contains all the information that the handwriting recognition engine needs to translate user input. First call HwxCreate, setting the hrc parameter to NULL. Call HwxSetGuide to specify a HWXGUIDE structure, and call HwxALCValid to specify an alphabet code (ALC) grouping. For each character or group of characters that an application collects from a user, copy the master HRC to another HRC for collecting and processing ink. After all of the ink in an HRC is processed, the HRC has served its purpose, so remove it with the HwxDestroy function. For the next collection of user input, copy the master HRC again, and so on.
The hrc parameter is used to copy settings from an old HRC into a new HRC object. These settings include alphabet code (ALC) groupings , the HWXGUIDE structure, the character previously processed, and ink that may be in the old context.
See Also