CheckMenuItem 函数 (winuser.h)

[CheckMenuItem 可用于“要求”部分中指定的操作系统。它可能在后续版本中变更或不可用。请改用 SetMenuItemInfo。 ]

将指定菜单项的检查标记属性的状态设置为选中或清除。

语法

DWORD CheckMenuItem(
  [in] HMENU hMenu,
  [in] UINT  uIDCheckItem,
  [in] UINT  uCheck
);

[in] hMenu

类型： HMENU

相关菜单的句柄。

[in] uIDCheckItem

类型： UINT

要设置其检查标记属性的菜单项，由 uCheck 参数确定。

[in] uCheck

类型： UINT

控制 uIDCheckItem 参数的解释和菜单项的检查-mark 属性的状态的标志。此参数可以是 MF_BYCOMMAND、 MF_BYPOSITION 和 MF_CHECKED 或 MF_UNCHECKED的组合。

值	含义
MF_BYCOMMAND 0x00000000L	指示 uIDCheckItem 参数提供菜单项的标识符。如果未指定 MF_BYCOMMAND 标志和 MF_BYPOSITION 标志，则 MF_BYCOMMAND 标志为默认值。
MF_BYPOSITION 0x00000400L	指示 uIDCheckItem 参数提供菜单项的从零开始的相对位置。
MF_CHECKED 0x00000008L	将检查标记属性设置为所选状态。
MF_UNCHECKED 0x00000000L	将检查标记属性设置为清除状态。

类型：DWORD

返回值指定菜单项的先前状态 (MF_CHECKED 或 MF_UNCHECKED) 。如果菜单项不存在，则返回值为 –1。

菜单栏中的项不能有检查标记。

uIDCheckItem 参数标识打开子菜单或命令项的项。对于打开子菜单的项， uIDCheckItem 参数必须指定项的位置。对于命令项， uIDCheckItem 参数可以指定项的位置或其标识符。


最低受支持的客户端	Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	winuser.h (包括 Windows.h)
Library	User32.lib
DLL	User32.dll
API 集	windows 8 中引入的 ext-ms-win-ntuser-menu-l1-1-0 ()

概念性

EnableMenuItem

引用