當我們提到動態菜單的實現時,我們通常的做法是使用GetMenu()函數獲取一個Cmenu類指針,然后調用CMenu類方法AppendMenu,InsertMenu,ModifyMenu,RemoveMenu等。本文介紹一種更加簡潔的方法,它利用MFC的消息映像機制及CCmdUI類方法來實現。
首先,我們簡要說說VC中MFC的消息映像。每個Windows程序員大概都對以前使用的窗口函數WindowProc記憶猶新,當我們面對各種消息時,我們別無他方,只能使用龐大而機械的switch-case語句來實現不同的分支選擇。在VC5.0中使用V4.2版的MFC基本類庫,你將告別switch-case語句,代之以透明的消息映像。要在一個類中使用消息映像,在類聲明中,必須顯式的加入宏DECLARE_MESSAGE_MAP:
class CMyClass: public CBaseClass
{
DECLARE_MESSAGE_MAP()
}
在類實現中,必須使用兩個宏BEGIN_MESSAGE_MAP和END_MESSAGE_MAP,BEGIN_MESSAGE_MAP帶兩個參數:當前類和直接父類:
BEGIN_MESSAGE_MAP(CMyClass,CBaseClass)
//消息映像項
ON_COMMAND(ID_APP_ABOUT,OnAppAbout)
//消息映像項
END_MESSAGE_MAP()
消息映像項使用下列基本語法:
ON_MessageName(ID,ClassMethod)
MessageName是需要處理的消息,ID是發送消息的標識符,而ClassMethod為處理此消息的類方法名。MessageName是MFC預定義的,可分為以下三種:
命令消息
子窗口通知消息
Windows消息
共一百多個,用戶不必記住它們,因為消息映像可以很簡單的利用ClassWizard加入。處理一個消息的類方法ClassMethod必須在類定義中聲明,且有實現代碼。其原型為:
Afx_msg return_type ClassMethod(paras table)
類CCmdUI專門(且僅僅)與ON_UPDATE_COMMAND_UI消息映像宏配套使用,用于管理菜單(還有工具欄按扭等)的實時狀態,如是否變灰,是否加選中標記等。
ON_UPDATE_COMMAND_UI消息映像宏原型為:
ON_UPDATE_COMMAND_UI(Menu_Item_ID,Menu_Proc)
ON_UPDATE_COMMAND_UI消息映像宏將一個菜單項(命令項)和一個更新處理過程聯結,從而在適當的時機自動調用此更新處理過程來完成對菜單項狀態的更新。
Menu_Item_ID為菜單項的ID號,Menu_Proc為此菜單項的更新處理函數,原型為:
afx_msg void Menu_Proc (CCmdUI* pCmdUI)
它帶有一個CCmdUI類指針,使用它可調用CCmdUI的類方法。與菜單有關的類方法有:
Enable(BOOL) 使菜單項有效或無效
SetText(LPCTSTR) 設置菜單項的文本
SetCheck(int) 加上或去掉選中標記“X”
SetRadio(BOOL) 加上或去掉選中標記“.”
MenuProc被調用的時機有以下幾種情況:
用鼠標選中包含該菜單項的菜單條
用熱鍵選中包含該菜單項的菜單條
用快捷鍵選中與該菜單項在同一菜單條下的任一菜單項
我們以下面菜單結構為例:
Test menu
Item One ID_ITEM_ONE Ctrl+1
Item Two ID_ITEM_TWO Ctrl+2
Popup Popup One ID_POPUP_ONE Ctrl+3
Popup Two ID_POPUP_TWO Ctrl+4
當用鼠標左鍵點按Test menu菜單條或按Alt+t或按Ctrl+1/2/3/4時,四個菜單項的更新處理過程MenuProc都將被調用。
當我們考察上面這個具有嵌套結構的菜單時,我們面臨這樣一個問題:菜單項Item One/Item Two的更新函數和Popup One/Popup Two的更新函數形式上是否一致?當Popup One和Popup Two都變灰時Popup是否自動變灰?
根據MFC的內部機制,僅僅彈出菜單的第一項應附加一些代碼,其余項的形式基本是一致的。也就是說在上例中,除菜單項Popup One外,其他菜單項更新函數的代碼基本一致,即根據條件,簡單調用CCmdUI類方法即可。菜單項Popup One由于是彈出式菜單Popup的第一項,它的更新函數在以下兩種情況下都會被調用:
當彈出式菜單(Popup)的菜單項(Popup One和Popup Two)要被繪出時
當此彈出式菜單即Popup本身要被繪出時
第一種情況很好理解,正如我們選中Test menu而Item One和Item Two的更新函數會自動執行一樣。第二種情況其實也很自然,因為Popup和Item One/Item Two不一樣,它沒有ID號,不能添加消息映像項,那么它的狀態如何更新呢?于是它的第一項的更新函數被調用,為了區分是不同的調用,它將CCmdUI的類成員變量m_pSubMenu設置為不同的值。在第一種情況下,m_pSubMenu等于NULL,第二種情況下,m_pSubMenu不等于NULL。
以下我們給出一個實際的編程范例。由于篇幅關系,我們僅僅給出一些關鍵的語句,其余的則一并略去。
在頭文件的類聲明中:
BOOL m_bItemOne, m_bItemTwo, m_bPopupOne, m_bPopupTwo;
//用于決定各個菜單項的狀態
protected:
afx_msg void OnUpdateMenuitemOne(CCmdUI* pCmdUI);
afx_msg void OnUpdateMenuitemTwo(CCmdUI* pCmdUI);
afx_msg void OnUpdatePopupOne(CCmdUI* pCmdUI);
afx_msg void OnUpdatePopupTwo(CCmdUI* pCmdUI);
//各菜單項的更新函數
DECLARE_MESSAGE_MAP()
在源文件中:
BEGIN_MESSAGE_MAP(CMyDoc, CDocument)
ON_UPDATE_COMMAND_UI (ID_ITEM_ONE,
OnUpdateMenuitemOne)
ON_UPDATE_COMMAND_UI (ID_ITEM_TWO,
OnUpdateMenuitemTwo)
ON_UPDATE_COMMAND_UI (ID_POPUP_ONE,
OnUpdatePopupOne)
ON_UPDATE_COMMAND_UI (ID_ POPUP_TWO,
OnUpdatePopupTwo)
END_MESSAGE_MAP()
void CMyApp::OnUpdatetMenuitemOne (CCmdUI* pCmdUI)
{
pCmdUI->Enable(m_bItemOne);
if(m_bItemOne) pCmdUI->SetText("Item One");
else pCmdUI->SetText("Item One is now disabled");
}
void CMyApp::OnUpdatetMenuitemTwo (CCmdUI* pCmdUI)
{
pCmdUI->Enable(m_bItemTwo);
if(m_bItemTwo) pCmdUI->SetText("Item Two");
else pCmdUI->SetText("Item Two is now disabled");
}
void CMyApp::OnUpdatePopupOne(CCmdUI* pCmdUI)
{
if (pCmdUI->m_pSubMenu != NULL)
{
BOOL b_Popup = m_bPopupOne || m_bPopupTwo;
pCmdUI->m_pMenu->EnableMenuItem(pCmdUI->m_nIndex,
MF_BYPOSITION |
(bEnable ? MF_ENABLED :
(MF_DISABLED | MF_GRAYED)));
return;
}
pCmdUI->Enable(m_bPopupOne);
}
void CMyApp::OnUpdatePopupTwo(CCmdUI* pCmdUI)
{
pCmdUI->Enable(m_bPopupTwo);
}