HwxCreate

This function creates a 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.

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.

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

HwxALCValid, HwxDestroy, HWXGUIDE, HwxSetGuide

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.