IMINFO (Compact 2013)

3/28/2014

This structure contains information about the size and available bitmaps for the input method.

Syntax

typedef struct{
  DWORD cbSize;
  HIMAGELIST hImageNarrow;
  HIMAGELIST hImageWide;
  int iNarrow;
  int iWide; 
  DWORD fdwFlags;
  RECT rcSipRect;
} IMINFO;

Members

• cbSize
  Size of the IMINFO structure. This member must be filled in by the software-based input panel (SIP) prior to calling IInputMethod::GetInfo.

• hImageNarrow
  Handle to an image list that contains the narrow 16x16 masked bitmaps for the IM. The SIP 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 SIP 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 SIP. The IM can change the bitmap displayed in the SIP 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 SIP.

• iWide
  Index to the hImageWide image list indicating which bitmap should be displayed by the SIP. The IM can change the bitmap displayed in the SIP taskbar button by calling IIMCallback::SetImInfo. The IM should change the bitmap on the InputPanel button when the IM is first selected into the SIP.

• fdwFlags
  Specifies flags representing state information of the SIP. It is any combination of the following bit flags.

  Value	Description
  SIPF_DOCKED	The SIP is docked, or not floating.
  SIPF_LOCKED	The SIP is locked, meaning that the user cannot change its visible status.
  SIP_OFF	The SIP is off, or not visible.
  SIPF_ON	The SIP 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 SIP. This sizing and placement information, returned from IInputMethod::GetInfo, is optionally used by the SIP to determine the default size and placement for the SIPl. The IIMCallback::SetImInfo method specifies the new size and placement of the SIP 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

Header	sip.h
sysgen	SYSGEN_SOFTKB

See Also

Reference

Software-based Input Panel Structures
SipGetInfo
IInputMethod::GetInfo
IIMCallback::SetImInfo