IMEMENUITEMINFO

[This is preliminary documentation and subject to change.]

The IMEMENUITEMINFO structure contains information about IME menu items.

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. This member can be one of the following values.

Value	Meaning
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. This member can have one or more of the following values.

Value	Meaning
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

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

hbmpItem

Handle to a bitmap to display.

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Requires Windows 98.
  Windows CE: Unsupported.
  Header: Declared in imm.h.
  Unicode: Defined as Unicode and ANSI structures.

See Also

Input Method Editor Overview, Input Method Editor Structures, ImmGetImeMenuItems