MM_QUERYITEM

This message returns the definition of the specified menu item.

Syntax

param1
USHORT usitem;           /* Item identifier. */
USHORT usincludesubmenus; /* Include submenus flag. */

param2
PMENUITEM pmenuitem;     /* Menu-item data structure. */

Parameters

usitem (USHORT) - input

Item identifier.

usincludesubmenus (USHORT) - input

Include submenus flag.

TRUE: If the menu does not have an item with the specified identifier, search

the submenus and subdialogs of the menu for an item with the specified identifier

and copy its definition.

FALSE: If the menu does not have an item with the specified identifier, do not

search the submenus and subdialogs of the menu for an item with the specified

identifier.

pmenuitem (PMENUITEM) - input

Menu-item data structure.

This points to a MENUITEM structure.

Returns

rc (BOOL) - return

Success indicator.

TRUE: Successful completion.

FALSE: Error occurred.

Remarks

The menu control window procedure responds to this message by copying the item definition specified by usitem, from the menu, to the structure specified by pmenuitem.

Note: This message does not retrieve the text for items with a style of MIS_TEXT. The item text is obtained by use of the MM_QUERYITEMTEXT message.

Default Processing

The default window procedure does not expect to receive this message and therefore takes no action on it, other than to set rc to the default value of FALSE.