This structure specifies the location of the input boxes on the screen.
At a Glance
| Header file: | Recog.h |
| Windows CE versions: | 2.0 and later |
Syntax
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.
See Also