msgs12.hlp (Topic list)
Important Notice
The pages on this site contain documentation for very old MS-DOS software, purely for historical purposes. If you're looking for up-to-date documentation, particularly for programming, you should not rely on the information found here, as it will be woefully out of date.
MM_SETITEM (1.2)
Message Group  Overview                           Up Next Previous
────────────────────────────────────────────────────────────────────────────
 
#define INCL_WINMENUS
 
MM_SETITEM
mp1 = MPFROM2SHORT(0, (BOOL) fIncludeSubMenus);
mp2 = (MPARAM) pmi;    /* pointer to MENUITEM structure */
 
An application sends an MM_SETITEM message to set a menu item. The menu
control responds to this message by copying the item definition in the
structure pointed to by the pmi parameter to the menu item with the same
identifier.
 
If the fIncludeSubMenus parameter is TRUE and the menu does not have an item
with the specified identifier, the submenus of this menu are searched for an
item with a matching identifier. If one is found, the definition is copied
to it.
 
Parameter         Description
────────────────────────────────────────────────────────────────────────────
 
fIncludeSubMenus  High word of mp1. Specifies whether to include submenus in
                  the search for an item that matches the id field of the
                  MENUITEM structure.
 
pmi               Low and high word of mp2. Points to a MENUITEM structure.
 
Return Value
 
The return value is TRUE if the operation is successful or FALSE if an error
occurs.
 
Comments
 
The iPosition field of the MENUITEM structure is ignored. The low word of
mp1 is not used and must be set to zero.
 
See Also
 
MM_QUERYITEM, MM_SETITEMATTR, MM_SETITEMHANDLE, MM_SETITEMTEXT, MENUITEM