This function sets the state of the specified menu item’s check mark attribute to either checked or unchecked.
At a Glance
| Header file: | Winuser.h |
| Windows CE versions: | 1.0 and later |
Syntax
DWORD CheckMenuItem(HMENU hmenu, UINT uIDCheckItem,
UINT uCheck);
Parameters
hmenu
[in] Handle to the menu of interest.
uIDCheckItem
[in] Specifies the menu item whose check-mark attribute is to be set, as determined by the uCheck parameter.
uCheck
[in] Specifies flags that control the interpretation of the uIDCheckItem parameter and the state of the menu item’s check-mark attribute. This parameter can be a combination of either MF_BYCOMMAND, or MF_BYPOSITION and MF_CHECKED or MF_UNCHECKED.
| Value | Description |
| MF_BYCOMMAND | Indicates that the uIDCheckItem parameter gives the identifier of the menu item. The MF_BYCOMMAND flag is the default, if neither the MF_BYCOMMAND nor MF_BYPOSITION flag is specified. |
| MF_BYPOSITION | Indicates that the uIDCheckItem parameter gives the zero-based relative position of the menu item. |
| MF_CHECKED | Sets the check-mark attribute to the checked state. |
| MF_UNCHECKED | Sets the check-mark attribute to the unchecked state. |
Return Values
The return value specifies the previous state of the menu item (either MF_CHECKED or MF_UNCHECKED). 0xFFFFFFFF indicates that the menu item does not exist.
Remarks
An item in a menu bar cannot have a check mark.
The uIDCheckItem parameter identifies a item that opens a submenu or a command item. For a item that opens a submenu, the uIDCheckItem parameter must specify the position of the item. For a command item, the uIDCheckItem parameter can specify either the item’s position or its identifier.
See Also