CMenu::CheckMenuItem

發行項
02/28/2013

加入核取記號或從在快顯功能表的功能表項目移除核取記號。

UINT CheckMenuItem(
   UINT nIDCheckItem,
   UINT nCheck 
);

參數

nIDCheckItem
指定由決定要簽出，功能表項目 nCheck。
nCheck
指定如何檢查功能表項目和如何判斷在功能表項目的位置。 nCheck 參數可以是 MF_CHECKED 或 MF_UNCHECKED 的組合與 MF_BYPOSITION 或 MF_BYCOMMAND 旗標。您可以使用或運算子，這些旗標可以使用位元的 OR 運算組合。它們具有下列意義:
- MF_BYCOMMAND 指定參數指定現有的功能表項目的命令 ID。這是預設值。
- MF_BYPOSITION 指定參數重新命名現有的功能表項目的位置。第一個項目在位置 0。
- MF_CHECKED 為具有 MF_UNCHECKED 的切換了項目旁邊放置預設核取記號。
- MF_UNCHECKED 為具有 MF_CHECKED 的切換了項目旁邊的核取記號。

傳回值

項目的前一個狀態: MF_CHECKED 或 MF_UNCHECKED或 0xFFFFFFFF，如果功能表項目不存在。

備註

nIDCheckItem 參數指定要修改的項目。

nIDCheckItem 參數會識別快顯功能表項目的功能表項目。不需要特殊的步驟來檢查快顯功能表項目。最上層的功能表項目無法簽出。因為它沒有功能表項目識別項關聯的，則必須依位置檢查快顯功能表項目。

範例

CMenu::GetMenuState。請參閱範例。

需求

Header: afxwin.h

請參閱

參考

階層架構圖

CMenu::GetMenuState

CMenu::CheckMenuRadioItem