MFC 消息映射、分派和传递
几个重要的结构体：
struct AFX_MSGMAP
{
AFX_MSGMAP* pBaseMessageMap;
AFX_MSGMAP_ENTRY* lpEntries;
}
struct AFX_MSGMAP_ENTRY
{
UINT nMessage;// Windows消息
UINT nCode;// 控制消息的通知码
UINT nID;// 其控制组件的ID
UINT nLastID;// 如果是一定范围的消息映射，此值表示区间的最大值
UINT nSig; // 消息的动作标识
AFX_MSG pfn;// 消息响应函数
}
此结构体的数据由任何一个ON_宏都会把这六个数据初始化，例如 此处的ON_WM_CREATE 和 下面提到的ON_COMMAND：
#define ON_WM_CREATE() \
{ WM_CREATE, 0, 0, 0, AfxSig_is, (AFX_MSG)(AFX_PMSGW)(int (AFX_MSG_CALL CWnd::*)(LPCREATESTRUCT)OnCreate) },
AFX_PMSG 是一个函数指针：
typedef void (CCmdTarget::* AFX_PMSG)(void);
定义一个DECLARE_MESSAGE_MAP()宏
#define DECLARE_MESSAGE_MAP() \ static AFX_MSGMAP_ENTRY _messageEntries[] ;\ static AFX_MSGMAP messageMap; \ virtual AFX_MSGMAP* GetMessageMap() const;
于是DECLARE_MESSAGE_MAP宏就相当于声明了下面的数据结构：
这个数据结构的内容填充工作由下面三个宏完成：
#define BEGIN_MESSAGE_MAP (theClass,baseClass) \
AFX_MSGMAP* theClass::GetMessageMap() const \
{ return &theClass::messageMap; }\
AFX_MSGMAP theClass::messageMap = \
{
&(baseClass::messageMap), \
(AFX_MSGMAP_ENTRY*) &(theClass::_messageEntries) ; \
} \
AFX_MSGMAP_ENTRY theClass::_messageEntries[] = \
{
#define ON_COMMAND(id,memberFxn) \
{ WM_COMMAND, 0, (WORD)id, (WORD)id, AfxSig_vv, (AFX_PMSG)memberFxn },
#define END_MESSAGE_MAP() \
{ 0, 0, 0, 0, AfxSig_end, (AFX_PMSG)0} \
};
这个AfxSig枚举的具体作用是什么呢？
上面的宏ON_WM_CREATE和ON_COMMAND也有出现类似的AfxSig_，那么到底作何用处？
从上面两个宏的最后一个参数可以看出，表示的是具体的执行函数，且都进行了类型转换，最终转换为AFX_PMSG.
可是AFX_PMSG的定义呢？我们再写一遍。
typedef void (CCmdTarget::* AFX_PMSG)(void);
这是一个什么鬼？无参，无返回值，不可能所有的函数都如此吧？
这正是AfxSig_的作用所在，当需要调用AFX_MSGMAP_ENTRY中的消息响应函数pfn的时候，具体的动作是这样的(出现在wincore.cpp CWnd::OnWndMsg 和 DispatchCmdMsg中)：
union MessageMapFunctions mmf;
mmf.pfn = lpEntry->pfn; // lpEntry 是AFX_MSGMAP_ENTRY的对象
switch(lpEntry->nSig)
{
case AfxSig_is:
lResult = (this->*mmf.pfn_is)((LPTSTR)lParam);
break;
case AfxSig_lwl:
lResult = (this->*mmf.pfn_lwl)(wParam, lParam);
break;
case AfxSig_vv:
lResult = (this->*mmf.pfn_vv)();
break;
.....
}
重点注意： MessageMapFunctions 和AfxSig_. AfxSig_ 定义位于AFXMSG_.H档。
enum AfxSig
{
AfxSig_end = 0, // [marks end of message map]
AfxSig_b_D_v, // BOOL (CDC*)
AfxSig_b_b_v, // BOOL (BOOL)
AfxSig_b_u_v, // BOOL (UINT)
AfxSig_b_h_v, // BOOL (HANDLE)
AfxSig_b_W_uu, // BOOL (CWnd*, UINT, UINT)
AfxSig_b_W_COPYDATASTRUCT, // BOOL (CWnd*, COPYDATASTRUCT*)
AfxSig_b_v_HELPINFO, // BOOL (LPHELPINFO);
AfxSig_CTLCOLOR, // HBRUSH (CDC*, CWnd*, UINT)
AfxSig_CTLCOLOR_REFLECT, // HBRUSH (CDC*, UINT)
AfxSig_i_u_W_u, // int (UINT, CWnd*, UINT) // ?TOITEM
AfxSig_i_uu_v, // int (UINT, UINT)
AfxSig_i_W_uu, // int (CWnd*, UINT, UINT)
AfxSig_i_v_s, // int (LPTSTR)
AfxSig_l_w_l, // LRESULT (WPARAM, LPARAM)
AfxSig_l_uu_M, // LRESULT (UINT, UINT, CMenu*)
.... // 后面很多不列举
};
MessageMapFunctions 定义于WINCORE.cpp 中：
union MessageMapFunctions
{
AFX_PMSG pfn; // generic member function pointer
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_D)(CDC*);
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_b)(BOOL);
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_u)(UINT);
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_h)(HANDLE);
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_W_u_u)(CWnd*, UINT, UINT);
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_W_COPYDATASTRUCT)(CWnd*, COPYDATASTRUCT*);
BOOL (AFX_MSG_CALL CCmdTarget::*pfn_b_HELPINFO)(LPHELPINFO);
HBRUSH (AFX_MSG_CALL CCmdTarget::*pfn_B_D_W_u)(CDC*, CWnd*, UINT);
HBRUSH (AFX_MSG_CALL CCmdTarget::*pfn_B_D_u)(CDC*, UINT);
int (AFX_MSG_CALL CCmdTarget::*pfn_i_u_W_u)(UINT, CWnd*, UINT);
int (AFX_MSG_CALL CCmdTarget::*pfn_i_u_u)(UINT, UINT);
int (AFX_MSG_CALL CCmdTarget::*pfn_i_W_u_u)(CWnd*, UINT, UINT);
int (AFX_MSG_CALL CWnd::*pfn_i_s)(LPTSTR);
int (AFX_MSG_CALL CWnd::*pfn_i_S)(LPCTSTR);
LRESULT (AFX_MSG_CALL CWnd::*pfn_l_w_l)(WPARAM, LPARAM);
LRESULT (AFX_MSG_CALL CWnd::*pfn_l_u_u_M)(UINT, UINT, CMenu*);
.... // 后面很多不列举
};
其实真正的函数只有pfn一个，但通过union后，它就有了许多类型不同的形象。这里可以看出union自动转型的作用。
//***********************************************************************************************
上面讲基本内容解释完毕，下面以实例来演示宏展开后的结果：
//in header file
class CView : public CWnd
{
public:
//...
DECLARE_MESSAGE_MAP()
};
//in implementation file
#define CViewid 122
//...
BEGIN_MESSAGE_MAP(CView, CWnd)
ON_COMMAND(CViewid, 0)
END_MESSAGE_MAP
//被展开之后为
//in header file
class CView : public CWnd
{
public:
//...
static AFX_MSGMAP_ENTRY _messageEntries[];
static AFX_MSGMAP messageMap;
virtual AFX_MSGMAP* GetMessageMap() const;
};
//in implementation file
AFX_MSGMAP* CView::GetMessageMap() const
{
return &CView::messageMap;
}
AFX_MSGMAP CView::messageMap = { &(CWnd::messageMap), (AFX_MSGMAP_ENTRY*)&(CView::_messageEntries) };
AFX_MSGMAP_ENTRY CView::_messageEntries[] = {
{WM_COMMAND, 0, (WORD)122, (WORD)122, 1, (AFX_MSGMAP)0},
{0, 0, 0, 0, 0, (AFX_MSGMAP)0}
};
以图表示则为：
MFC中定义了各种类似ON_COMMAND这样的宏，把各式各样的消息与特定的消息处理函数关联起来。
下面的代码中每一个CCmdTarget的衍生类都产生类似上图的消息映射表：
//in head file
class CObject
{
//....
//注意：CObject并不属于消息流动网的一份子
};
class CCmdTarget :public CObject
{
//...
DECLARE_MESSAGE_MAP()
};
class CWinThread :public CCmdTarget
{
//...
//注意：CWinThread并不属于消息流动网的一份子
};
class CWinApp :public CWinThread
{
//...
DECLARE_MESSAGE_MAP()
};
class CDocument :public CCmdTarget
{
//...
DECLARE_MESSAGE_MAP()
};
class CWnd :public CCmdTarget
{
//...
DECLARE_MESSAGE_MAP()
};
class CFrameWnd :public CWnd
{
//...
DECLARE_MESSAGE_MAP()
};
class CView :public CWnd
{
//...
DECLARE_MESSAGE_MAP()
};
class CView :public CWnd
{
//...
DECLARE_MESSAGE_MAP()
};
class CMyWinApp :public CWinApp
{
//...
DECLARE_MESSAGE_MAP()
};
class CMyFrameWnd :public CFrameWnd
{
//...
DECLARE_MESSAGE_MAP()
};
class CMyDoc :public CDocument
{
//...
DECLARE_MESSAGE_MAP()
};
class CMyView :public CView
{
//...
DECLARE_MESSAGE_MAP()
};
//in implementation file
BEGIN_MESSAGE_MAP(CWnd, CCmdTarget)
ON_COMMAND(CWndid, 0)
END_MESSAGE_MAP
BEGIN_MESSAGE_MAP(CFrameWnd, CWnd)
ON_COMMAND(CFrameWndid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CDocument, CCmdTarget)
ON_COMMAND(CDocumentid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CView, CWnd)
ON_COMMAND(CViewid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CWinApp, CCmdTarget)
ON_COMMAND(CWinAppid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CMyWinApp, CWinApp)
ON_COMMAND(CMyWinAppid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CMyFrameWnd, CFrameWnd)
ON_COMMAND(CMyFrameWndid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CMyDoc, CDocument)
ON_COMMAND(CMyDocid, 0)
END_MESSAGE_MAP()
BEGIN_MESSAGE_MAP(CMyView, CView)
ON_COMMAND(CMyViewid, 0)
END_MESSAGE_MAP()
//同时也设定了消息的终极标靶CCmdTarget的映射表内容：
AFX_MSGMAP CCmdTarget::messageMap =
{
NULL,
&CCmdTarget::_messageEntries[0]
};
AFX_MSGMAP_ENTRY CCmdTarget::_messageEntries =
{
{0, 0, CCmdTargetid, 0, AfxSig_end, 0 }
}
以上构成了完整的消息流动网，如下图：
