IMEMENUITEMINFO

This structure contains information about IME menu items.

At a Glance

Header file: Imm.h
Windows CE versions: 2.10 and later

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 of the structure in bytes.

fType

Menu item type. It is one of the following values:

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. It can be one or more of the following values.

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

Specifies an application-defined value associated with the menu item.

szString

Null-terminated string that contains the content of the menu item.

hbmpItem

Handle to a bitmap to display.