Compartilhar via


IInputMethod2 (Windows Embedded CE 6.0)

1/6/2010

This interface is implemented by the input method (IM) component. The software-based 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 callback interface, it is up to the developer to implement the following methods.

Methods

Method Description

Select

Implemented to create the windows and image list for the IM.

Deselect

Implemented to select the IM out of the software-based input panel window and to destroy the IM windows.

Showing

Implemented to perform any initialization before the software-based input panel window is displayed.

Hiding

Implemented to perform any saving routines before the software-based input panel is hidden.

GetInfo

Implemented to return information about the current IM to the operating system.

ReceiveSipInfo

Implemented to receive information about the size, placement, and docked status of the software-based input panel.

RegisterCallback

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

GetImData

Implemented to send data from the current IM to the current application.

SetImData

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

UserOptionsDlg

Implemented when the user requests that an IM-specific options dialog box be presented.

SetIMMActiveContext

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

RegisterCallback2

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

Remarks

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

  1. Select
  2. GetInfo
  3. ReceiveSipInfo
  4. RegisterCallback

Requirements

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

See Also

Reference

IInputMethod2::Deselect
IInputMethod2::GetImData
IInputMethod2::GetInfo
IInputMethod2::Hiding
IInputMethod2::ReceiveSipInfo
IInputMethod2::RegisterCallback
IInputMethod2::RegisterCallback2
IInputMethod2::Select
IInputMethod2::SetImData
IInputMethod2::SetIMMActiveContext
IInputMethod2::Showing
IInputMethod2::UserOptionsDlg

Other Resources

Software-based Input Panel Interfaces