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.

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

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.12 and later Sip.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

IInputMethod::Deselect, IInputMethod::GetImData, IInputMethod::GetInfo, IInputMethod::Hiding, IInputMethod::ReceiveSipInfo, IInputMethod::RegisterCallback, IInputMethod::Select, IInputMethod::UserOptionsDlg

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.