基本介紹
- 外文名：CheckMenuItem
- 函式類型：API函式
- uIDCheckItem ：指定要修改的選單項
- uCheck ：表示標記的狀態
API函式,MFC函式,功能,函式原型,參數,返回值,備註,示例,頭檔案,
API函式
函式原型：DWORD CheckMenuItem(HMENU hmenu, UINT uIDCheckItem, UINT uCheck);
參數：
hmenu：含有其選單項的標誌將被提取得的選單的句柄。
uId：其某單標誌將被取得的選單項，此參數含義由參數uFlags決定。
UFlags：用於指定參數uld的含義的值。此參數可取下列值之一：
MF_BYCOMMAND：表示參數uId給出選單項的標識符。如果MF_BYCOMMAND和MF_BYPOSITION都沒被指定，則MF_BYCOMMAND是預設值。
MF_BYPOSITION：表示參數uId給出選單項相對於零的位置。
返回值：如果指定的項不存在，返回值是OXFFFFFFFF；如果選單項打開了一個子選單，則返回值的低位含有與選單相聯繫的選單標誌，高位含有子選單的項數。否則，返回值是萊單標誌的掩碼（布爾OR）。
下面列出與選單項相關的選單標誌。
MF_CHECKED：放置選取標記於選單項旁邊（只用於下拉式選單、子選單或快捷選單）。
MF_DISABLED：使選單項無效。MF_GRAYED：使選單項無效並變灰。MF_HILITE：加亮選單項。
MF_MENUBARBREAK：對下拉式選單、子選單和快捷選單，新列和舊列由垂直線隔開，其餘功能同MF_MENUBREAK標誌。
MF_SEPARATOR：創建一個水平分隔線（只用於下拉式選單、子選單或快捷選單）。
MF_UNCHECKED: 相當於MF_CHECKED 的反作用，取消放置於選單項旁邊的標記。
MFC函式
功能
在彈出式子選單中的選單對象中添加或刪除複選標記
函式原型
UINT CheckMenuItem( UINT nIDCheckItem, UINT nCheck );
參數
nIDCheckItem
指定將要操作的選單對象，可以由該選單對象的命令ID指定，也可由該選單對象的索引號指定，具體的指定方式由第二個參數指定。
nCheck
由兩部分按或運算組合。其一為MF_BYCOMMAND或MF_BYPOSITION，其二為MF_CHECKED 或MF_UNCHECKED。四個取值的含義如下：
MF_BYCOMMAND：表明應該根據選單對象的命令來訪問選單項，即第一個參數是定的是選單項的命令ID
MF_BYPOSITION：表明應該根據選單對象的位置來訪問選單項，即第一個參數是定的是選單對象的索引號
MF_CHECKED：設定選單對象的複選標記
MF_UNCHECKED：移除選單對象的複選標記
返回值
返回選單對象設定之前的標記方式：MF_CHECKED或MF_UNCHECKED，若選單對象不存在則返回0xFFFFFFFF
備註
nIDCheckItem參數指定將要修改的對象。
nIDCheckItem參數可以指定選單項或彈出式子選單，指定彈出式子選單時不需要特殊的步驟。但要注意不能指定選單欄的選單對象。在指定彈出式子選單時只能通過索引號指定，因為沒有與彈出式選單關聯的命令。
示例
參見MSDN
頭檔案
afxwin.h
