HwxSetGuide

This function points to a structure that specifies the size and position on a screen  of input boxes, which collect characters drawn by a user.

BOOL HwxSetGuide ( 
HRC hrc, 
HWXGUIDE * lpGuide );

Parameters

  • hrc
    [in] Handle to the handwriting recognition context (HRC) object.
  • lpGuide
    [in] Long pointer to a HWXGUIDE structure.

Return Values

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

Remarks

Call HwxSetGuide after the HwxCreate function and before accepting user input to the HRC with calls to the HwxInput function. The handwriting recognition engine requires that an application specify a HWXGUIDE structure for HRC objects.

The HWXGUIDE structure can define one input area, or box, or it can define many input areas. When the guide contains multiple input boxes, HwxGetResults returns results for multiple characters.

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

HwxCreate, HwxGetResults, HWXGUIDE,HwxInput

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.