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

See also

Input Method Manager

Input Method Manager Messages

ImmIsUIMessage