CheckMenuRadioItem

  • Article

This function checks a specified menu item and makes it a radio item. At the same time, the function clears all other menu items in the associated group and 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

OS Versions: Windows CE 1.0 and later.
Header: Winuser.h.
Link Library: Menu.lib.

See Also

MENUITEMINFO | Menu Functions

Last updated on Wednesday, April 13, 2005

© 2005 Microsoft Corporation. All rights reserved.