WM_IME_SETCONTEXT

The WM_IME_SETCONTEXT message is sent to an application when a window of the application is activated. If the application has created an IME window, it should call the ImmIsUIMessage function. Otherwise, it should pass this message to the DefWindowProc function.

fSet = (BOOL) wParam;
iShow = (DWORD) lParam;
 

Parameters

fSet
Active flag. If TRUE, the input context is active. If FALSE, the context is inactive.
iShow
Show flags. This parameter can be a combination of the following values.
Value Description
ISC_SHOWUICOMPOSITIONWINDOW Shows the composition window by UI window.
ISC_SHOWUIGUIDWINDOW Shows the guide window by UI window
ISC_SHOWUISOFTKBD Shows the soft keyboard by UI window
ISC_SHOWUICANDIDATEWINDOW Shows the candidate window of Index 0 by UI window.
ISC_SHOWUICANDIDATEWINDOW << 1 Shows the candidate window of Index 1 by UI window.
ISC_SHOWUICANDIDATEWINDOW << 2 Shows the candidate window of Index 2 by UI window.
ISC_SHOWUICANDIDATEWINDOW << 3 Shows the candidate window of Index 3 by UI window.

If the application draws the composition window, the default IME window does not need 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 the DefWindowProc or ImmIsUIMessage functions.

Return Values

Returns the value returned by DefWindowProc or ImmIsUIMessage.

QuickInfo

  Windows NT: Requires version 4.0 or later.
  Windows: Requires Windows 95 or later.
  Windows CE: Requires version 2.0 or later.
  Header: Declared in imm.h.

See Also

Input Method Editor Overview, Input Method Editor Messages, DefWindowProc, ImmIsUIMessage