Share via

IInputMethod2::SetIMMActiveContext

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method is implemented to receive the current state of the IME.

Syntax

HRESULT SetIMMActiveContext(
  HWND hwnd, 
  BOOL bOpen,
  DWORD dwConversion, 
  DWORD dwSentence, 
  DWORD hkl
);

Parameters

  • hwnd
    Handle of window control that has changed context.
  • bOpen
    Specifies whether the IME is on. TRUE indicates the IME is on; otherwise, this parameter is FALSE.
  • dwConversion
    The current IME conversion mode status.
  • dwSentence
    The current IME sentence mode status.
  • hkl
    A handle to the current active keyboard layout.

Return Value

Return S_OK to indicate success. Return the appropriate HRESULT value to indicate failure.

Remarks

The SetIMMActiveContext interface to the software-based input panel is exposed only through this method. The software-based input panel calls this method when ImmSetActiveContext is called on a window control.

Requirements

Header sip.h
Library uuid.lib
Windows Embedded CE Windows CE 2.12 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IInputMethod2