IMR_CONFIRMRECONVERTSTRING notification code

Notifies an application when the IME needs to change the RECONVERTSTRING structure. The application receives this command through the WM_IME_REQUEST message with parameter settings as shown below.

LRESULT IMR_CONFIRMRECONVERTSTRING

Parameters

wParam

Set to IMR_CONFIRMRECONVERTSTRING.

lParam

Pointer to a RECONVERTSTRING structure from the IME. For more information, see the Remarks section.

Return Value

Returns a nonzero value if the application accepts the changed RECONVERTSTRING structure. Otherwise, the command returns 0 and the IME uses the original RECONVERTSTRING structure.

Remarks

The application fills in the RECONVERTSTRING structure upon receiving the IMR_RECONVERTSTRING command.

After the application has handled IMR_RECONVERTSTRING, the IME might or might not adjust the RECONVERTSTRING structure. The IME sends WM_IME_REQUEST with IMR_CONFIRMRECONVERTSTRING to confirm the changes to the RECONVERTSTRING structure. If the application returns TRUE for IMR_CONFIRMRECONVERTSTRING, the IME generates a new composition string based on the RECONVERTSTRING structure for the IMR_CONFIRMRECONVERTSTRING command. If the application returns FALSE for IMR_CONFIRMRECONVERTSTRING, the IME generates a new composition string based on the original RECONVERTSTRING structure specified by the application in the IMR_RECONVERTSTRING command.

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 Windows.h)

See also

Input Method Manager

Input Method Manager Commands

IMR_RECONVERTSTRING

RECONVERTSTRING

WM_IME_REQUEST