IInputMethod3::RegisterCallback (Compact 2013)

3/28/2014

Implement this method to receive a pointer to an IIMCallback interface.

Syntax

HRESULT RegisterCallback( 
  IIMCallback* pIMCallback
);

pIMCallback
[in] Pointer to an IIMCallback interface that is implemented in the software-based input panel (SIP). The input method can call methods on this interface to send information back to the SIP.

Returns S_OK to indicate success; otherwise, returns the appropriate HRESULT value to indicate that it was not successful.

This method is the only way to access the IIMCallback interface to the SIP. The SIP calls this method during the initialization of the input method (IM), along with IInputMethod3::Select, IInputMethod3::GetInfo, and IInputMethod3::ReceiveSipInfo.

An input method uses the IIMCallback interface to send keystrokes to applications and to change the icons on the Input Panel.