Share via

HwxCreate

  • Article

This function creates a handwriting recognition context (HRC) object. A handwriting recognition engine uses the HRC object to obtain ink, or information that describes what the user is drawing. The engine stores 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 the GetLastError function.

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 an 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

OS Versions: Windows CE .NET 4.0 and later.
Header: Recog.h.
Link Library: Hwxjpn.lib, Hwxusa.lib, Hwxcht.lib, Hwxkor.lib.

See Also

HwxALCValid | HwxDestroy | HWXGUIDE | HwxSetGuide

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.