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的組合。

值	意義
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)
程式庫	User32.lib
Dll	User32.dll
API 集合	ext-ms-win-ntuser-menu-l1-1-0 (在 Windows 8) 中引進