IMINFO
This structure contains information regarding the size and available bitmaps for the input method (IM).
typedef struct {
DWORD cbSize;
HIMAGELIST hImageNarrow;
HIMAGELIST hImageWide;
int iNarrow;
int iWide;
DWORD fdwFlags;
RECT rcSipRect;
} IMINFO;
Members
cbSize
Size of the IMINFO structure. For the Palm-size PC, this member must be filled in by the input panel prior to calling IInputMethod::GetInfo.hImageNarrow
Handle to an image list that contains the narrow 16x16 masked bitmaps for the IM. The input panel displays a bitmap from this image list to indicate the currently selected IM.hImageWide
Handle to an image list that contains the wide 32x16 masked bitmaps. The input panel displays a bitmap from this image list to indicate the currently selected IM.iNarrow
Index to the hImageNarrow image list indicating which bitmap should be displayed by the input panel. The IM can change the bitmap displayed in the input panel taskbar button by calling IIMCallback::SetImInfo. The IM should change the bitmap on the Input Panel button when the IM is first selected into the input panel.iWide
Index to the hImageWide image list indicating which bitmap should be displayed by the input panel. The IM can change the bitmap displayed in the input panel taskbar button by calling IIMCallback::SetImInfo. The IM should change the bitmap on the Input Panel button when the IM is first selected into the input panel.fdwFlags
Specifies flags representing state information of the input panel. It is any combination of the following bit flags:Value Description SIPF_DOCKED The input panel is docked, or not floating. SIPF_LOCKED The input panel is locked, meaning that the user cannot change its visible status. SIP_OFF The input panel is off, or not visible. SIPF_ON The input panel is on, or visible. The SIP state flags are ignored for the SipGetInfo function, but are used in the IIMCallback::SetImInfo callback method.
rcSipRect
Rectangle, in screen coordinates, representing the size and location of the input panel. This sizing and placement information, returned from IInputMethod::GetInfo, is optionally used by the input panel to determine the default size and placement for the input panel. The IIMCallback::SetImInfo method specifies the new size and placement of the input panel window.
Remarks
The Input Panel button displays the 32x16 bitmap button when there are only a few other controls on the taskbar. At times, there may not be enough room on the taskbar to display all the controls. During these times, the Input Panel button shrinks to half its normal width and uses the 16x16 bitmap.
Requirements
Runs On | Versions | Defined in | Include | Link to |
---|---|---|---|---|
Windows CE OS | 2.01 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
SipGetInfo, IInputMethod::GetInfo, IIMCallback::SetImInfo
Last updated on Tuesday, July 13, 2004
© 1992-2000 Microsoft Corporation. All rights reserved.