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 參數解釋及選單項目勾選標記屬性狀態的旗標。此參數可為 MF_BYCOMMAND、 MF_BYPOSITION 與 MF_CHECKED 或 MF_UNCHECKED的組合。

價值	Meaning
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）。若選單項目不存在，則回傳值為UINT_MAX。

選單列中的項目不能有勾選標記。

uIDCheckItem 參數用來識別開啟子選單或指令項目的項目。對於開啟子選單的項目， uIDCheckItem 參數必須指定該項目的位置。對於指令項目， uIDCheckItem 參數可以指定該項目的位置或識別碼。

需求	價值
最低支援的用戶端	Windows 2000 專業版 [僅限桌面應用程式]
支援的最低伺服器	Windows 2000 伺服器 [僅限桌面應用程式]
目標平臺	Windows 作業系統
標頭	winuser.h （包括 Windows.h）
範本庫	User32.lib
DLL	User32.dll
API 集	ext-ms-win-ntuser-menu-l1-1-0（於 Windows 8 引入）