Compartilhar via

IInputMethod

  • Artigo

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/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

The following table lists methods for IInputMethod.

Method Description

IInputMethod::Select

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

IInputMethod::Deselect

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

IInputMethod::Showing

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

IInputMethod::Hiding

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

IInputMethod::GetInfo

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

IInputMethod::ReceiveSipInfo

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

IInputMethod::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.

IInputMethod::GetImData

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

IInputMethod::SetImData

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

IInputMethod::UserOptionsDlg

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

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. RegisterCallback
  3. GetInfo
  4. ReceiveSipInfo

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

Other Resources

Software-based Input Panel Interfaces