Export (0) Print
Expand All
1 out of 2 rated this helpful - Rate this topic

CheckMenuRadioItem 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 clears the radio-item type flag for those items.

Syntax


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

Parameters

hmenu [in]

Type: HMENU

A handle to the menu that contains the group of menu items.

idFirst [in]

Type: UINT

The identifier or position of the first menu item in the group.

idLast [in]

Type: UINT

The identifier or position of the last menu item in the group.

idCheck [in]

Type: UINT

The identifier or position of the menu item to check.

uFlags [in]

Type: UINT

Indicates 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 value

Type: BOOL

If the function succeeds, the return value is nonzero.

If the function fails, the return value is zero. To get extended error information, use the GetLastError function.

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 selected 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.

Examples

For an example, see Example of Example of Using Custom Checkmark Bitmaps.

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

Header

Winuser.h (include Windows.h)

Library

User32.lib

DLL

User32.dll

See also

Reference
MENUITEMINFO
Conceptual
Menus

 

 

Community Additions

ADD
Show:
© 2014 Microsoft. All rights reserved.