系列快速导航:三要点
1、 CDocTemplate 学习MFC框架如何创建的过程.CDocTemplate
2、 CFrameWnd::LoadFrame 学习MFC框架如何创建的过程.LoadFrame
3、 CWnd::ProcessShellCommand
学习MFC框架如何创建的过程.CWnd::ProcessShellCommand.上部
学习MFC框架如何创建的过程.CWnd::ProcessShellCommand.下部
研究CWnd::ProcessShellCommand
第一个MDI子窗口是从这里面建立出来的,这实在是缺乏直观性。不过MFC就是这样,没办法。
BOOL CWinApp::ProcessShellCommand(CCommandLineInfo& rCmdInfo) { BOOL bResult = TRUE; switch (rCmdInfo.m_nShellCommand) { case CCommandLineInfo::FileNew: if (!AfxGetApp()->OnCmdMsg(ID_FILE_NEW, 0, NULL, NULL)) // 关键是这里 OnFileNew(); if (m_pMainWnd == NULL) bResult = FALSE; break; case CCommandLineInfo::FileOpen: // 忽略 case CCommandLineInfo::FilePrintTo: // 忽略 case CCommandLineInfo::FilePrint: case CCommandLineInfo::FileDDE: case CCommandLineInfo::AppRegister: case CCommandLineInfo::AppUnregister: } return bResult; } |
进入到ProcessShellCommand,要处理很多种不同命令,我们忽略其它命令,单独看FileNew部分。
注意:实际进入到了AfxGetApp()->OnCmdMsg(ID_FILE_NEW, 0, NULL, NULL)之中。
AfxGetApp()实际返回了CMDITestApp的唯一实例,它从CWinApp – CWinThread – CCmdTarget – CObject 派生而来。我们没有重载OnCmdMsg,所以进入到CCmdTarget的OnCmdMsg处理中。为了研究,我们删减了一些代码。
BOOL CCmdTarget::OnCmdMsg(UINT nID, int nCode, void* pExtra, AFX_CMDHANDLERINFO* pHandlerInfo) { // 这里删减了一些代码 // determine the message number and code (packed into nCode) const AFX_MSGMAP* pMessageMap; const AFX_MSGMAP_ENTRY* lpEntry; UINT nMsg = 0; // 这里删减了一些代码,处理后 nMsg = WM_COMMAND // 为了简化,删减了一些断言等。以下循环用于查找处理此消息的入口。 for (pMessageMap = GetMessageMap(); pMessageMap->pfnGetBaseMap != NULL; pMessageMap = (*pMessageMap->pfnGetBaseMap)()) { lpEntry = AfxFindMessageEntry(pMessageMap->lpEntries, nMsg, nCode, nID); if (lpEntry != NULL) { // 找到了消息处理项入口,分发此消息。 return _AfxDispatchCmdMsg(this, nID, nCode, lpEntry->pfn, pExtra, lpEntry->nSig, pHandlerInfo); } } return FALSE; // 未找到则不处理 } |
最终MFC很愉快地找到了一个入口项, CWinApp::OnFileNew(void) 要处理这个消息。继续进入到_AfxDispatchCmdMsg中去看看。
AFX_STATIC BOOL AFXAPI _AfxDispatchCmdMsg(CCmdTarget* pTarget, UINT nID, int nCode, AFX_PMSG pfn, void* pExtra, UINT_PTR nSig, AFX_CMDHANDLERINFO* pHandlerInfo) // return TRUE to stop routing { union MessageMapFunctions mmf; mmf.pfn = pfn; BOOL bResult = TRUE; // default is ok if (pHandlerInfo != NULL) { // just fill in the information, don't do it pHandlerInfo->pTarget = pTarget; pHandlerInfo->pmf = mmf.pfn; return TRUE; } switch (nSig) { case AfxSigCmd_v: // normal command or control notification ASSERT(CN_COMMAND == 0); // CN_COMMAND same as BN_CLICKED ASSERT(pExtra == NULL); (pTarget->*mmf.pfnCmd_v_v)(); // ? 实际调用 pTarget 指向的这个成员函数 break; // 下面还有大量的多种 AfxSigCmd_xxx,忽略掉它们。 default: // illegal ASSERT(FALSE); return 0; break; } return bResult; } |
其中 (pTarget->*mmf.pfn_Cmd_v_v)() 对CWinApp::OnFileNew() 产生调用,pTarget = CMDITestApp类实例。调用进入如下:
void CWinApp::OnFileNew() { if (m_pDocManager != NULL) m_pDocManager->OnFileNew(); } |
进入进入到CDocManager::OnFileNew()
void CDocManager::OnFileNew() { if (m_templateList.IsEmpty()) // 提示没有模板并返回 CDocTemplate* pTemplate = (CDocTemplate*)m_templateList.GetHead(); // 第一个 if (m_templateList.GetCount() > 1) // 弹出一个对话框(很难看的)提示用户选择一个文档模板 // 在这个例子里面,pTemplate 就是 CMDITestApp::InitInstance() 里面创建的那个模板 pTemplate->OpenDocumentFile(NULL); } |
在进入CMultiDocTemplate::OpenDocumentFile之前,我观察了一下调用堆栈,结果如下:
> mfc71d.dll!CDocManager::OnFileNew() 行852 C++ mfc71d.dll!CWinApp::OnFileNew() 行25 C++ mfc71d.dll!_AfxDispatchCmdMsg(CCmdTarget * pTarget=0x0042cae8, unsigned int nID=57600, int nCode=0, void (void)* pfn=0x0041153c, void * pExtra=0x00000000, unsigned int nSig=53, AFX_CMDHANDLERINFO * pHandlerInfo=0x00000000) 行89 C++ mfc71d.dll!CCmdTarget::OnCmdMsg(unsigned int nID=57600, int nCode=0, void * pExtra=0x00000000, AFX_CMDHANDLERINFO * pHandlerInfo=0x00000000) 行396 + 0x27 C++ mfc71d.dll!CWinApp::ProcessShellCommand(CCommandLineInfo & rCmdInfo={...}) 行27 + 0x1e C++ MDITest.exe!CMDITestApp::InitInstance() 行101 + 0xc C++ |
希望我还没有迷路:)
CMultiDocTemplate::OpenDocumentFile 又是很多很多代码,让我们选择一些。
CDocument* CMultiDocTemplate::OpenDocumentFile(LPCTSTR lpszPathName, BOOL bMakeVisible) { // 以下代码删减了验证、断言部分 CDocument* pDocument = CreateNewDocument(); // 创建文档对象 CFrameWnd* pFrame = CreateNewFrame(pDocument, NULL); // 创建框架窗口 if (lpszPathName == NULL) { pDocument->OnNewDocument(); // 初始化文档 } else // 打开已有文档 InitialUpdateFrame(pFrame, pDocument, bMakeVisible); return pDocument; } |
看一看CreateNewDocument()
CDocument* CDocTemplate::CreateNewDocument() { // default implementation constructs one from CRuntimeClass if (m_pDocClass == NULL) // 错误提示啦 // CRuntimeClass* m_pDocClass -> CreateObject 实例化文档类。 // 在此例子中既是 CMDITestDoc CDocument* pDocument = (CDocument*)m_pDocClass->CreateObject(); AddDocument(pDocument); // 添加到模板里的文档列表,MultiDocTemplate 保存此一文档 return pDocument; } |