HwxSetContext

This function specifies to the handwriting recognition context (HRC) which character the user previously entered. Using this character, the handwriting recognition engine can more accurately determine the character it is currently processing.

BOOL HwxSetContext ( 
HRC hrc, 
WCHAR wContext );

Parameters

• hrc
  [in] Handle to the handwriting recognition context (HRC) object.
• wContext
  [in] Unicode value of the character input by the user prior to the character that is processed in hrc. If this parameter is 0, the recognition engine does not use context information when identifying the character.

Return Values

TRUE indicates success. FALSE indicates failure. To get extended error information, call GetLastError.

Remarks

Call this function before calling the HwxProcess function. If HwxSetContext is not called, the handwriting recognition engine does not use context information to determine the character. Having context information greatly improves the performance of the handwriting recognition engine. Without context information, for example, it is difficult for the handwriting recognition engine to distinguish a lowercase l from the numeral one (1).

Requirements

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

HwxProcess

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.