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.

ValueMeaning
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

 

 

Show: