IMECHARPOSITION structure (imm.h)

Contains information about the character position in the composition window.

Syntax

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

Members

dwSize

Size of the structure, in bytes.

dwCharPos

Character offset in the composition string, in TCHAR values.

pt

A POINT structure containing the coordinate of the top left point of requested character in screen coordinates. The top left point is based on the character baseline in any text flow.

cLineHeight

Height of a line that contains the requested character, in pixels.

rcDocument

A RECT structure containing the editable area for text, in screen coordinates, for the application.

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 structure.

Requirements

Requirement Value
Minimum supported client Windows 2000 Professional [desktop apps only]
Minimum supported server Windows 2000 Server [desktop apps only]
Header imm.h (include Immdev.h, Windows.h)

See also

IMR_QUERYCHARPOSITION

Input Method Manager

Input Method Manager Structures