函式功能
該函式在選單的指定位置插入一個新選單項。
函式原型
BOOL WINAPI InsertMenuItem(HMENU hMenu,UINT ultem,BOOL fByPosition,LPMENUITEMINFO lpmii );
參數
hMenu:新選單項將被插入其中的選單的句柄。
ultem:在其前面插入新選單項的選單項的標識符或位置。此參數的含義取決於參數fByPosition的值。
fByFosition:用於確定ultem的含義的值。如果此參數為FALSE,Ultem表示選單項的標識符。否則,ultem 表示選單項的位置。
lpmii:指向結構MENUITEMINFO的指針,該結構中包含了新選單項的信息。
返回值:如果函式調用成功,返回非零值;如果函式調用失敗,返回值是零。若想獲得更多的錯誤信息,請調用GetLastError函式。
備註:為了使鍵盤加速鍵能控制點陣圖或自己繪製的選單項,選單的擁有者必須處理WM_MENUCHAR訊息。
參見自繪製選單和WM_MENUCHAR訊息。
速查:Windows NT:4.0及以上版本;Windows:95及以上版本;Windows CE:不支持;頭檔案:winuser.h; 輸入庫:user32.lib Unicode:在Windows NT環境下,以Unicode和ANSI方式實現。
MFC 下的例子:
CMenu menu;
menu.CreatePopupMenu();//創建一個空的彈出選單
GetMenu()->InsertMenu(0,MF_BYPOSITION | MF_POPUP,(UINT)menu.m_hMenu,“TEST1");//在選單項第0個位置插入“TEST1”
menu.AppendMenu(MF_STRING,111,“Hello”);