IInputMethod

This interface is implemented by the input method (IM) component. The input panel calls the methods of this interface to notify the IM of state changes and to request action and information from the IM. Because an IM is a COM interface, it is up to the developer to implement the following methods.

At a Glance

Header file: Sip.h
Windows CE Versions: 2.01 and later

Method Description
IInputMethod::Select Implemented to create the windows and image list for the input method (IM).
IInputMethod::Deselect Implemented to select the input method (IM) out of the input panel window and to destroy the IM windows.
IInputMethod::Showing Implemented to perform any initialization before the input panel window is displayed.
IInputMethod::Hiding Implemented to perform any saving routines before the input panel is hidden.
IInputMethod::GetInfo Implemented to return information about the current input method (IM) to the operating system.
IInputMethod::ReceiveSipInfo Implemented to receive information about the size, placement, and docked status of the input panel.
IInputMethod::RegisterCallback Implemented to receive a pointer to an IIMCallback interface. An input method (IM) uses the IIMCallback interface to send keystrokes to applications and to change the icons on the Input Panel button.
IInputMethod::GetImData Implemented to send data from the current input method (IM) to the current application.
IInputMethod::SetImData Implemented to respond to an application’s request to set input method (IM)-specific data within the IM.
IInputMethod::UserOptionsDlg Implemented when the user requests that an input method (IM)-specific options dialog box be presented.

Remarks

An IM receives method calls in the following sequence before it is required to render the input panel window space or to respond to user actions:

  1. Select

  2. GetInfo

  3. ReceiveSipInfo

  4. RegisterCallback