當我們提到動態菜單的實現時,我們通常的做法是使用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);
}