WM_IME_CHAR

This message is sent to an application when the IME gets a character of the conversion result. Unlike the WM_CHAR message, this message can include double-byte as well as single-byte character values.

At a Glance

Header file: Imm.h
Windows CE versions: 2.10 and later

Syntax

chCharCode1 = (WORD) wParam;
lKeyData = lParam;

Parameters

chCharCode1 and chCharCode2

(For double-byte character sets) Single- or double-byte character value. For a double-byte character, chCharCode1 contains the lead byte.

chCharCode1

(For Unicode) Unicode character value.

lKeyData

Repeat count, scan code, extended-key flag, context code, previous key-state flag, and transition-state flag, as shown following:

Value Description
0–15 Repeat count: Since the first byte and second byte is continuous, this is always 1.
16–23 Scan Code: Scan code for a complete FE character.
24–28 Not used.
29 Context code.
31 Conversion state.

Remarks

If the WM_IME_CHAR message includes a double-byte character and the application passes this message to DefWindowProc, the IME converts this message into two WM_CHAR messages, each containing one byte of the double-byte character.