|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
CheckMenuItem
The CheckMenuItem function sets the state of the specified menu item's check mark attribute to
either checked or unchecked.
The CheckMenuItem function has been superseded by the SetMenuItemInfo function. You can still use CheckMenuItem, however, if you do not need any of the extended features of SetMenuItemInfo.
DWORD CheckMenuItem(
HMENU hmenu,
| // handle to menu
| UINT uIDCheckItem,
| // menu item to check or uncheck
| UINT uCheck
| // menu item flags
| );
|
|
Parameters
hmenu
Identifies the menu of interest.
uIDCheckItem
Specifies the menu item whose check-mark attribute is to be set, as determined
by the uCheck parameter.
uCheck
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
| Meaning
| 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). If the menu item does not exist, the return value is
0xFFFFFFFF.
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
EnableMenuItem, GetMenuCheckMarkDimensions, GetMenuItemID, SetMenuItemBitmaps, SetMenuItemInfo
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
