IInputMethodEx

4/8/2010

IInputMethodEx is implemented by the input method (IM) component. The input panel calls the IInputMethodEx interfaces to notify the IM of state changes and to request action and information from the IM. Because an IM is a COM interface, the following methods can be implemented.

Method Description

Deselect

Selects the IM from the Input Panel window and eliminates the IM window.

GetImData

Sends data from the current IM to the current application.

GetInfo

Returns information about the current IM to the operating system.

Hiding

Performs any saving routines before the input panel is hidden.

ReceiveSipInfo

Receives information about the size, placement, and docked status of the input panel.

RegisterCallback

Receives a pointer to an IIMCallback interface. An IM uses the IIMCallback interface to send keystrokes to applications and to change the icons on the InputPanel button.

IInputMethodEx::RegisterCallbackEx

Receives a pointer to an IIMCallbackEx interface. An IM uses the IIMCallbackEx interface to send keystrokes to applications and to change the icons on the Input Panel button.

Select

Creates the windows and image list for the IM.

SetImData

Responds to an application's request to set IM-specific data within the IM.

IInputMethodEx::SetIMMActiveContext

Called when ImmSetActiveContext is called. The information identifies the current state of the IME.

Showing

Performs any initialization before the Input Panel window is displayed.

UserOptionsDlg

Presents the User Options dialog box for a specific IM.

Note

Except for SetIMMActiveContext and RegisterCallbackEx, all the IInputMethodEx interface methods are identical to the IInputMethod methods.

If a custom IM component is developer, the new component should have the Setup application perform self-registration by calling the DllRegisterServer and DllUnregisterServer functions. Implement these functions in the IM server DLL. Optionally, the registry values can be set directly. The input panel Properties dialog box does not provide any UI elements for the self-registration service.

Requirements

Header sip.h
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Pocket PC 2000 and later

See Also

Other Resources

Software-based Input Panel Interfaces