Share via

CMenu::CheckMenuRadioItem

  • Article

BOOL CheckMenuRadioItem( UINT nIDFirst**, UINT** nIDLast**, UINT** nIDItem**, UINT** nFlags );

Return Value

Nonzero if successful; otherwise 0

Parameters

nIDFirst

Specifies (as an ID or offset, depending on the value of nFlags) the first menu item in the radio button group.

nIDLast

Specifies (as an ID or offset, depending on the value of nFlags) the last menu item in the radio button group.

nIDItem

Specifies (as an ID or offset, depending on the value of nFlags) the item in the group which will be checked with a radio button.

nFlags

Specifies interpretation of nIDFirst, nIDLast, and nIDItem in the following way:

nFlags Interpretation
MF_BYCOMMAND Specifies that the parameter gives the command ID of the existing menu item. This is the default if neither MF_BYCOMMAND nor MF_BYPOSITION is set.
MF_BYPOSITION Specifies that the parameter gives the position of the existing menu item. The first item is at position 0.

Remarks

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. The checked item is displayed using a radio button (or bullet) bitmap instead of a check mark bitmap.

Example

See the example for ON_COMMAND_RANGE.

CMenu Overview |  Class Members |  Hierarchy Chart

See Also   CMenu::CheckMenuItem, CMenu::GetMenuState,