HwxInput

Article
06/30/2006

This function adds stroke information to the handwriting recognition context (HRC).

BOOL HwxInput ( 
HRC hrc, 
POINT * lppnt, 
UINT upoints, 
DWORD timestamp );

Parameters

hrc
[in] Handle to the handwriting recognition context (HRC) object.
lppnt
[in] Long pointer to an address of an array of POINTPOINT structures. The information in the POINT structures should be scaled to match the HWXGUIDE structure.
upoints
[in] Number of POINT structures.
timestamp
[in] Time stamp when a device, such as a stylus, started adding information to the input box. The time stamp should be taken directly from the MSG structure for the stylus down event.

Return Values

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

Remarks

As a user draws a character, an application calls this function to add user input, or ink, to the HRC object one stroke at a time. A stroke consists of stylus down, stylus movement, and stylus lift. HwxInput takes the array of points, the count of the points, and the time stamp of the first stylus event in the stroke and adds it to the HRC object. When an application determines that there is no more ink to receive for an HRC, it calls the HwxEndInput function.

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

HwxEndInput, HWXGUIDE, MSG, POINT

Last updated on Tuesday, July 13, 2004

HwxInput

Additional resources