Share via

IInputMethod (Compact 2013)

  • Article

3/28/2014

This interface is implemented by the input method (IM) component. The software-based input panel (SIP) 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 SIP window and to destroy the IM windows.

IInputMethod::Showing

Implemented to perform any initialization before the SIP window is displayed.

IInputMethod::Hiding

Implemented to perform any saving routines before the SIP 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 SIP.

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 SIP window space or to respond to user actions:

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

Requirements

Header

sip.h

Library

uuid.lib

See Also

Reference

Software-based Input Panel Interfaces