共用方式為


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

意義
MF_BYCOMMAND
0x00000000L
表示 uIDCheckItem 參數會提供功能表項目的識別碼。 如果未指定MF_BYCOMMANDMF_BYPOSITION旗標,則MF_BYCOMMAND旗標是預設值。
MF_BYPOSITION
0x00000400L
表示 uIDCheckItem 參數會提供功能表項目以零起始的相對位置。
MF_CHECKED
0x00000008L
將核取記號屬性設定為選取的狀態。
MF_UNCHECKED
0x00000000L
將核取記號屬性設定為清除狀態。

傳回值

類型: DWORD

傳回值會指定功能表項目先前的狀態, (MF_CHECKEDMF_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) 中引進

另請參閱

概念

EnableMenuItem

GetMenuItemID

功能表

參考

SetMenuItemBitmaps

SetMenuItemInfo