IMEMENUITEMINFO 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;
  TCHAR   szString[IMEMENUITEM_STRING_SIZE];
  HBITMAP hbmpItem;
} IMEMENUITEMINFO, *PIMEMENUITEMINFO;

Members

cbSize

Size, in bytes, of the structure.

fType

Menu item type. This member can have one of the following values.

ValueMeaning
IMFT_RADIOCCHECKDisplay checked menu items using a radio-button mark instead of a check mark if the hbmpChecked member is NULL.
IMFT_SEPARATORMenu 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_SUBMENUMenu item is a submenu.

 

fState

Menu item state. This member can have one or more of the following values:

ValueMeaning
IMFS_CHECKEDThe menu item is checked. For more information, see the description of the hbmpChecked member.
IMFS_DEFAULTThe menu item is the default. A menu can contain only one default menu item, which is displayed in bold.
IMFS_DISABLEDThe menu item is disabled and appears dimmed so it cannot be selected. This is equivalent to IMFS_GRAYED.
IMFS_ENABLEDThe menu item is enabled. This is the default state.
IMFS_GRAYEDThe menu item is disabled and appears dimmed so it cannot be selected. This is equivalent to IMFS_DISABLED.
IMFS_HILITEThe menu item is highlighted.
IMFS_UNCHECKEDThe menu item is unchecked. For more information about unchecked menu items, see the description of the hbmpUnchecked member.
IMFS_UNHILITEThe 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

Content of the menu item. This is a null-terminated string.

hbmpItem

Handle to a bitmap to display.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Imm.h (include Windows.h)

Unicode and ANSI names

IMEMENUITEMINFOW (Unicode) and IMEMENUITEMINFOA (ANSI)

See also

Input Method Manager
Input Method Manager Structures
ImmGetImeMenuItems

 

 

Show: