HWXGUIDE

This structure specifies the location of the input boxes on the screen.

typedef struct tagHWXGUIDE {
UINT cHorzBox;
UINT cVertBox;
INT xOrigin;
INT yOrigin;
UINT cxBox;
UINT cyBox;
UINT cxOffset;
UINT cyOffset;
UINT cxWriting;
UINT cyWriting;
UINT cyMid;
UINT cyBase;
UINT nDir 
} HWXGUIDE, *PHWXGUIDE;

Members

  • cHorzBox
    Number of input boxes positioned horizontally.

  • cVertBox
    Number of input boxes positioned vertically.

  • xOrigin
    Specifies the x-coordinate for the upper-left corner of the input area.

  • yOrigin
    Specifies the y-coordinate for the upper-left corner of the input area.

  • cxBox
    Width of a single box.

  • cyBox
    Height of a single box.

  • cxOffset
    Specifies the x-coordinate offset within a box to the upper-left of the writing area.

  • cyOffset
    Specifies the y-coordinate offset within a box to the upper-left of the writing area.

  • cxWriting
    Width of the writing area.

  • cyWriting
    Height of the writing area.

  • cyMid
    Midline information measured from the top of the writing area. For English or any language based on Latin letters, it must be set to the appropriate value. For the Far East languages—Japanese, Chinese, and Korean—this member is not used and must be set to zero.

  • cyBase
    Baseline value measured from the top of the writing area. For English or any language based on Latin letters, it must be set to the appropriate value. For the Far East languages—Japanese, Chinese, and Korean—this member is not used and must be set to zero.

  • nDir
    Writing direction. The following values are defined, but each is not necessarily supported:

    HWX_BIDIRECTIONAL
    HWX_HORIZONTAL
    HWX_VERTICAL

    If an application specifies an unsupported writing direction in a call to HwxSetGuide, an error is returned.

Remarks

This structure is passed in to HwxSetGuide, and it specifies where the boxes are located on the screen. All positions are in scaled screen coordinates. You should do the scaling so that cyWriting is about 1,000 units. To avoid speed and rounding problems, use an integral multiple of your actual size.

The writing area must be centered. To do this, set cxBox, cxOffset, and cxWriting such that cxBox = = 2 * cxOffset + cxWriting.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 2.0 and later Recog.h    

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

HwxSetGuide

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.