MM_STARTMENUMODE

This message is used to begin menu selection.

Syntax

param1
USHORT usshowsubmenu; /* Show submenu flag. */
USHORT usresumemenu;  /* Resume menu mode flag. */

param2
ULONG ulReserved;   /* Reserved value, should be 0. */

Parameters

usshowsubmenu (USHORT) - input

Show submenu flag.

TRUE: Show the submenu (pull-down menu) of the selected action bar item when

the menu enters selection mode. If the action bar is not visible, the submenu

is shown, otherwise it is not shown. If the item selected does not have a

submenu, this parameter is ignored.

FALSE: Do not show the submenu (pull-down menu) of the selected action bar

item when the menu enters selection mode.

usresumemenu (USHORT) - input

Resume menu mode flag.

TRUE: Resume the user interaction with the menu from where it left off.

The menu is assumed to have been used previously and left without dismissing one of

the submenus, and therefore is resumed in that submenu.

FALSE: Begin user interaction with the menu from the action bar, subject to

the value of the usshowsubmenu parameter.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

rc (BOOL) - return

Success indicator.

TRUE: Successful completion.

FALSE: Error occurred.

Remarks

It is posted to the menu when the operator presses the menu key.

Note: It must be posted, not sent, to the menu control.

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.