Share via


IInputMethod::Deselect

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This method is implemented to select the input method (IM) out of the software-based input panel window and to destroy the IM windows.

Syntax

HRESULT Deselect(void);

Return Value

Return S_OK to indicate success. Return the appropriate HRESULT value to indicate failure.

Remarks

This method is called before IUnknown::Release is called on the IInputMethod pointer. This method provides an IM a place to perform cleanup activities, such as destroying windows and pointers. This method, along with the IUnknown::Release call, is the only notification that an IM receives that it is to be unloaded.

Do not call the IIMCallback::SetImInfo method within the implementation of IInputMethod::Deselect. If you call IIMCallback::SetImInfo, the IM fails to notify applications about the window and workspaces for the IM, which can cause the IM window to overlay application workspace.

Requirements

Header sip.h
Library uuid.lib
Windows Embedded CE Windows CE 2.01 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

IIMCallback::SetImInfo

Other Resources

IUnknown::Release