MM ISITEMVALID

This message returns the selectable status of a specified menu item.

Syntax

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

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

Parameters

usitem (USHORT) - input

Item identifier.

usincludesubmenus (USHORT) - input

Include submenus indicator.

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.

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.

ulReserved (ULONG) - input

Reserved value, should be 0.

Returns

rc (BOOL) - returns

Selectable indication.

A menu item can be selected and entered under these conditions:

The item is enabled and, if it is a submenu item, the item in the action bar associated with the submenu is enabled. If the action bar item is not enabled, the user cannot display the submenu.

The item is enabled, and the submenu is displayed and being tracked with the pointing device or keyboard. It is unlikely, but possible, that the associated action bar is disabled in this instance.

TRUE: The user can select and enter the specified item.

FALSE: The user cannot select and enter the specified item.

Remarks

The menu control window procedure responds to this message by setting the return value depending on the selectable status of the specified item.

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.