WM_IME_SETCONTEXT message

Sent to an application when a window is activated. A window receives this message through its WindowProc function.

LRESULT CALLBACK WindowProc(
  HWND  hwnd,  
  WM_IME_SETCONTEXT,  
  WPARAM wParam,      
  LPARAM lParam      
);

Parameters

hwnd

A handle to window.

wParam

TRUE if the window is active, and FALSE otherwise.

lParam

Display options. This parameter can have one or more of the following values.

Value Meaning
ISC_SHOWUICOMPOSITIONWINDOW
Show the composition window by user interface window.
ISC_SHOWUIGUIDWINDOW
Show the guide window by user interface window.
ISC_SHOWUISOFTKBD
Show the soft keyboard by user interface window.
ISC_SHOWUICANDIDATEWINDOW
Show the candidate window of index 0 by user interface window.
ISC_SHOWUICANDIDATEWINDOW << 1
Show the candidate window of index 1 by user interface window.
ISC_SHOWUICANDIDATEWINDOW << 2
Show the candidate window of index 2 by user interface window.
ISC_SHOWUICANDIDATEWINDOW << 3
Show the candidate window of index 3 by user interface window.

 

Return value

Returns the value returned by DefWindowProc or ImmIsUIMessage.

Remarks

If the application has created an IME window, it should call ImmIsUIMessage. Otherwise, it should pass this message to DefWindowProc.

If the application draws the composition window, the default IME window does not have to show its composition window. In this case, the application must clear the ISC_SHOWUICOMPOSITIONWINDOW value from the lParam parameter before passing the message to DefWindowProc or ImmIsUIMessage. To display a certain user interface window, an application should remove the corresponding value so that the IME will not display it.

Requirements

Minimum supported client
Windows 2000 Professional [desktop apps only]
Minimum supported server
Windows 2000 Server [desktop apps only]
Header
Winuser.h (include Windows.h);
Imm.h (include Windows.h)

See also

Input Method Manager

Input Method Manager Messages

ImmIsUIMessage