IMR_CONFIRMRECONVERTSTRING

The IMR_CONFIRMRECONVERTSTRING command is sent when the IME needs to change the RECONVERTSTRING structure (previously filled in by the application upon receiving the IMR_RECONVERTSTRING command).

The application receives this command through the WM_IME_REQUEST message with wParam and lParam set as follows.

Parameters

wParam

Set to IMR_CONFIRMRECONVERTSTRING.

lParam

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

Return Values

Returns a nonzero value if the application accepts the changed RECONVERTSTRING structure. Otherwise, returns zero and the IME will use the original RECONVERTSTRING.

Remarks

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

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 Commands, IMR_RECONVERTSTRING, RECONVERTSTRING, WM_IME_REQUEST