CheckMenuRadioItem

This function checks a specified menu item and makes it a radio item. At the same time, the function unchecks all other menu items in the associated group and clears the radio-item type flag for those items.

BOOL API CheckMenuRadioItem(
HMENU hmenu, 
UINT idFirst, 
UINT idLast, 
UINT idCheck, 
UINT uFlags ); 

Parameters

  • hmenu
    [in] Handle to the menu that contains the group of menu items.
  • idFirst
    [in] Identifier or position of the first menu item in the group.
  • idLast
    [in] Identifier or position of the last menu item in the group.
  • idCheck
    [in] Identifier or position of the menu item to check.
  • uFlags
    [in] Value that specifies the meaning of idFirst, idLast, and idCheck. If this parameter is MF_BYCOMMAND, the other parameters specify menu item identifiers. If it is MF_BYPOSITION, the other parameters specify the menu item positions.

Return Values

Nonzero indicates success. Zero indicates failure. To get extended error information, call GetLastError.

Remarks

The CheckMenuRadioItem function sets the MFT_RADIOCHECK type flag and the MFS_CHECKED state for the item specified by idCheck and, at the same time, clears both flags for all other items in the group. The checked item is displayed using a bullet bitmap instead of a check-mark bitmap.

For more information about menu item type and state flags, see the MENUITEMINFO structure.

Requirements

Runs on Versions Defined in Include Link to
Windows CE OS 1.0 and later Winuser.h   Menu.lib

Note   This API is part of the complete Windows CE OS package as provided by Microsoft. The functionality of a particular platform is determined by the original equipment manufacturer (OEM) and some devices may not support this API.

See Also

GetLastError, MENUITEMINFO

 Last updated on Tuesday, July 13, 2004

© 1992-2000 Microsoft Corporation. All rights reserved.