IMEMENUITEMINFO

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This structure contains information about IME menu items.

Syntax

typedef struct tagIMEMENUITEMINFO {
  UINT cbSize; 
  UINT fType; 
  UINT fState; 
  UINT wID; 
  HBITMAP hbmpChecked; 
  HBITMAP hbmpUnchecked; 
  DWORD dwItemData; 
  WCHAR szString[IMEMENUITEM_STRING_SIZE]; 
  HBITMAP hbmpItem; 
} IMEMENUITEMINFO, *PIMEMENUITEMINFO, NEAR *NPIMEMENUITEMINFO, FAR *LPIMEMENUITEMINFO;

Members

• cbSize
  Size, in bytes, of the structure.

• fType
  Menu item type. The following table shows the possible values for fType.

  Value	Description
  IMFT_RADIOCCHECK	Displays checked menu items using a radio-button mark instead of a check mark if the hbmpChecked member is NULL.
  IMFT_SEPARATOR	Specifies that the menu item is a separator. A menu item separator appears as a horizontal dividing line. The hbmpItem and szString members are ignored in this case.
  IMFT_SUBMENU	Specifies that the menu item is a submenu.

• fState
  Menu item state. The following table shows the possible values for fState.

  Value	Description
  IMFS_CHECKED	The menu item is checked. For more information, see the description of the hbmpChecked member.
  IMFS_DEFAULT	The menu item is the default. A menu can contain only one default menu item, which is displayed in bold.
  IMFS_DISABLED	The menu item is disabled but not shaded. It can still be selected.
  IMFS_ENABLED	The menu item is enabled. This is the default state.
  IMFS_GRAYED	The menu item is disabled and shaded so it cannot be selected.
  IMFS_HILITE	The menu item is highlighted.
  IMFS_UNCHECKED	The menu item is unchecked. For more information about unchecked menu items, see the description of the hbmpUnchecked member.
  IMFS_UNHILITE	The menu item is not highlighted. This is the default state.

• wID
  Application-defined 16-bit value that identifies the menu item.

• hbmpChecked
  Handle to the bitmap to display next to the item if it is checked. If this member is NULL, a default bitmap is used. If the IMFT_RADIOCHECK type value is specified, the default bitmap is a bullet. Otherwise, it is a check mark.

• hbmpUnchecked
  Handle to the bitmap to display next to the item if it is not checked. If this member is NULL, no bitmap is used.

• dwItemData
  Application-defined value associated with the menu item.

• szString[IMEMENUITEM_STRING_SIZE]
  Null-terminated string that contains the content of the menu item.

• hbmpItem
  Handle to a bitmap to display.

Requirements