IInputMethod2::ReceiveSipInfo

This method is implemented for the IM to receive information about the size, placement, and docked status of the input panel.

HRESULT ReceiveSipInfo( 
SIPINFO *psi);

Parameters

  • psi
    Pointer to a SIPINFO structure. Because this method only provides information regarding the size, placement and docked status of the input panel, only the rcSipRect member and the SIPF_DOCKED flag, if set, of the fdwFlags member are valid in this SIPINFO structure.

Return Values

An appropriate HRESULT value is returned.

Remarks

The input panel calls this method to provide the IM with the current size, placement, and docked status of the input panel. This method is called whenever the user, an application, or the IM changes the input panel state. The IM should respond to these new values by changing its own state. However, it could also ignore these values. For example, a developer can implement an IM that is larger or smaller than the standard size for an IM. These values have either been selected by the user, or have been recommended as expected input panel values for that platform.

The input panel also calls this method during the initialization of the IM, along with Select, GetInfo, and RegisterCallback.

Requirements

Runs On Versions Defined in Include Link to
Windows CE OS 2.12 and later Sip.h    

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

IInputMethod2::GetInfo, IInputMethod2::RegisterCallback, IInputMethod2::Select, SIPINFO

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.