IIMCallback2::SetImInfo (Windows CE 5.0)
This method is called by the input method (IM) to change the bitmaps shown on the Input Panel button, to change the visible state of the software-based input panel, or to notify the software-based input panel when the IM has changed the size, placement, or docked status of the software-based input panel window.
HRESULT SetImInfo( IMINFO* pimi);
Parameters
- pimi
Pointer to an IMINFO structure containing the new IM settings, including the size, placement, and state of the software-based input panel window. The IMINFO structure also contains indexes to the bitmaps for the Input Panel button.
Return Values
An appropriate HRESULT value is returned.
Remarks
IMs use this method to alter part of the software-based input panel state. For example, an IM may include a user interface element that allows the user to toggle the software-based input panel between a docked and floating state. However, the software-based input panel uses all values passed in the IMINFO structure. Therefore, the IM must create and initialize an IMINFO structure that is identical to the current IMINFO structure. The IM should toggle the SIPF_DOCKED flag in the fdwFlags member, and use the altered IMINFO structure in this method. Much of the information in the IMINFO structure is also contained in the SIPINFO structure. An IM receives this information upon initialization, with the IInputMethod2::ReceiveSipInfo method.
Applications written for Windows CE can access the SIPINFO structure using the SipSetInfo function.
For Windows CE 2.12 and later, an IM can set the rcSipRect member of the IMINFO structure to set the new position of the SIP window. If rcSipRect is zeroed-out, then rcSipRect is ignored and no position is altered.
Requirements
OS Versions: Windows CE 2.12 and later.
Header: Sip.h.
Link Library: Uuid.lib.
See Also
SipSetInfo | IInputMethod2::ReceiveSipInfo | IMINFO | SIPINFO
Send Feedback on this topic to the authors