Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

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.

Syntax

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] Constant 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 position. For more information about the constants, see Menus Constants.

Return Value

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

Remarks

The CheckMenuRadioItemfunction sets the MFT_RADIOCHECK type flag and the MFS_CHECKED state for the item specified by idCheckand, 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 MENUITEMINFOstructure.

Requirements

Header winuser.h
Library Menu.lib
Windows Embedded CE Windows CE 1.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also