Share via

IMEMENUITEMINFO

  • Article

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

Header imm.h
Windows Embedded CE Windows CE .NET 4.0 and later
Windows Mobile Windows Mobile Version 5.0 and later