Platform SDK: International Features

IMECHARPOSITION

The IMECHARPOSITION structure contains information about the character position in the composition window.

typedef struct tagIMECHARPOSITION {
  DWORD  dwSize;
  DWORD  dwCharPos;
  POINT  pt;
  UNIT   cLineHeight;
  RECT   rcDocument;
} IMECHARPOSITION, *PIMECHARPOSITION;

Members

dwSize
Size of the structure in bytes.
dwCharPos
Character offset in the composition string, in TCHARs.
pt
A POINT structure containing the coordinate of the top left (based upon character baseline in any text flow) point of requested character in screen coordinates.
cLineHeight
Height of a line which contains the requested character, in pixels.
rcDocument
A RECT structure containing the application's editable area for text, in screen coordinates

Remarks

When an application uses IME to draw the composition string, the members of this structure are automatically filled. Applications that draw the composition string themselves, rather than relying on the IME, are responsible for filling all the fields defined in the IMECHARPOSITION structure.

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 98.
  Header: Declared in Imm.h.

See Also

Input Method Editor Overview, Input Method Editor Structures, IMECHARPOSITION, IMR_QUERYCHARPOSITION, POINT, RECT