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.

At a Glance

Header file: Recog.h
Windows CE versions: 2.0 and later

Syntax

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”).

See Also

HwxProcess