Setting Up the HWXGUIDE Structure

You define the size and position of the box or boxes that are used for character entry within the HWXGUIDE structure. The HwxSetGuide function provides the recognition engine with the coordinates to the HWXGUIDE structure for interpreting the input coordinates. The following illustration shows the dimensions of an input box for character entry.

The base (cyBase) and the midline (cyMid) in the HWXGUIDE structure are used primarily for characters and are not required for glyphs. Placement of a specific box within the display on the target device is defined by the xOrigin and yOrigin parameters. Offset parameters establish a buffer space between each box when multiple boxes are used, which helps prevent the user from overwriting ink data from one box into another. In the event that you overwrite ink data, the recognition engine must determine to which box the ink data corresponds.

After initializing the handwriting recognition engine by using the HwxConfig function, the entire recognition process begins and ends with the creation and destruction, respectively, of a handwriting recognition context (HRC) object. Similar to a handle to a window or a handle to a device context, an HRC is a unique 32-bit handle that is used by the recognition engine for handwriting recognition. An HRC is used for input in a single box or multiple boxes. It carries all of the ink data and setup parameters that are necessary for recognizing a glyph, one character, or multiple characters. Use the HwxCreate and HwxDestroy functions, respectively, to create and destroy an HRC object.

See Also

Handwriting Recognition | Recognizing a Hand-Drawn Character

 Last updated on Friday, April 09, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.