MFC单文档视图穷追猛打

 

目录
 

 

第一章找回WinMain函数 2

第二章InitApplication()函数 2

第三章InitInstance ()函数 3

第一节：new CSingleDocTemplate 3

第二节：AddDocTemplate(pDocTemplate); 5

第三节：ProcessShellCommand(cmdInfo) 5

第一段AfxGetApp()->OnCmdMsg(…) 6

第二段OnFileNew(); 6

第四节 ：m_pMainWnd->ShowWindow(SW_SHOW); ///显示窗口 8

第五节 ：m_pMainWnd-> UpdateWindow (); ///重画窗口 8

第四章pApp->Run函数 8

第五章总结 8

 

  本文将针对一个单文档来描述MFC的文档/视图结构，他直接打开MFC的源代码进行分析，在分析过程中去掉了无关的部分。所以第一步就是要创建一个称为First得工程，文档类型是单文档，下文将围绕这个工程来讲的。

第一章找回WinMain函数

首先在VC的安装路径中找到WINMAIN.CPP文件，AfxWinMain函数就是VC编译器的入口，去掉一些不重要的东西后得到如下得程序。

int AFXAPI AfxWinMain (HINSTANCE hInstance, HINSTANCE hPrevInstance,LPTSTR lpCmdLine, int nCmdShow)

{

int nReturnCode = -1;

CWinApp* pApp = AfxGetApp(); ///获取应用程序类的指针与文档视图无关。

AfxWinInit(hInstance, hPrevInstance,lpCmdLine,nCmdShow); ///与文档视图无关。

pApp->InitApplication();  ///初始化应用程序详见下文。

pApp->InitInstance();     ///最重要下面祥述

nReturnCode = pApp->Run();///消息循环直到应用程序被关闭。与文档视图无关。

AfxWinTerm();      ///与文档视图无关。

return nReturnCode;///整个应用结束。

}

下面分节讲述。

第二章InitApplication()函数

在文件Appcore.cpp文件中InitApplication如下：

BOOL CWinApp::InitApplication()

{

 if (CDocManager::pStaticDocManager != NULL)   ///这段和我们关系不大,暂时不理它

 {

  if (m_pDocManager == NULL)

   m_pDocManager = CDocManager::pStaticDocManager;

  CDocManager::pStaticDocManager = NULL;

 }

 

 if (m_pDocManager != NULL)

  m_pDocManager->AddDocTemplate(NULL);

 else

  CDocManager::bStaticInit = FALSE;  /*我们的程序将会执行到这句,表示文档类用动态方式创建,也就是说用RUNTIME_CLASS来创建的(详见下文)。*/

 return TRUE;

}

  说明：CDocManager类是一个不公开的类，他主要用来管理多文档模板对象的，对于单文档只有一个文档模板这个类不是很重要，但还是用它管理文档模板的；本文只在相关之处作说明。bStaticInit是它的一个静态成员。

第三章InitInstance ()函数

  它一般被重载，在First工程中，InitInstance中和文档视图类有关的程序有下面的一些：

 

 CSingleDocTemplate* pDocTemplate;  ///定义指针

 pDocTemplate = new CSingleDocTemplate(

  IDR_MAINFRAME,

  RUNTIME_CLASS(CFirstDoc),

  RUNTIME_CLASS(CMainFrame),

  RUNTIME_CLASS(CFirstView));    ///这条语句的作用见第一段

 AddDocTemplate(pDocTemplate);

 

 CCommandLineInfo cmdInfo;    ///定义一个对象

 ParseCommandLine(cmdInfo);    ///解析命令行并发送参数，与文档视图无关

 

 if (!ProcessShellCommand(cmdInfo))   ///这是最重要的详见的三段

  return FALSE;

 

 m_pMainWnd->ShowWindow(SW_SHOW);      ///显示窗口

 m_pMainWnd->UpdateWindow();

第一节：new CSingleDocTemplate

new CSingleDocTemplate其实就是创建一个CSingleDocTemplate对象并调用他的构造函数，要讲清楚这句话，首先必须明白RUNTIME_CLASS结构，RUNTIME_CLASS结构定义如下：

#define RUNTIME_CLASS(class_name) ((CRuntimeClass*)(&class_name::class##class_name))

于是这句话展开后如下(关于符合##的具体意义参见MSDN)：

 pDocTemplate = new CSingleDocTemplate(

IDR_MAINFRAME,

(CRuntimeClass*)(&CFirstDoc::classCFirstDoc),

(CRuntimeClass*)(&CMainFrame::classCMainFrame),

(CRuntimeClass*)(&CFirstView::classCFirstView));

这时我们会发现CfirstDoc，CmainFrame，CfirstView各会多冒出一个静态成员出来，它究竟在哪里呢？查看这三个类的定义我们会发现每个类定义都有一个宏DECLARE_DYNCREATE，在实现文件中有另外一个宏IMPLEMENT_DYNCREATE。下面把这些宏的展开情况列出如下：

（1）文档类

DECLARE_DYNCREATE(CFirstDoc) 展开后为：

public: 

 static const CRuntimeClass classCFirstDoc; ///这就是上面所说的那个静态成员

 virtual CRuntimeClass* GetRuntimeClass() const;

 static CObject* PASCAL CreateObject();

 

IMPLEMENT_DYNCREATE(CFirstDoc, CDocument)  展开后为：

 CObject* PASCAL CFirstDoc::CreateObject()

  { return new CFirstDoc; }

 const CRuntimeClass CFirstDoc::classCFirstDoc= {

  "CFirstDoc", sizeof(class CFirstDoc), 0xFFFF, CFirstDoc::CreateObject,    (CRu

ntimeClass*)(&CDocument::classCDocument), NULL };

 CRuntimeClass* CFirstDoc::GetRuntimeClass() const

  { return (CRuntimeClass*)(&CFirstDoc::classCFirstDoc); }

（2）视图类

DECLARE_DYNCREATE(CFirstView)  展开后为：

public: 

 static const CRuntimeClass classCFirstView;

 virtual CRuntimeClass* GetRuntimeClass() const;

 static CObject* PASCAL CreateObject();

 

IMPLEMENT_DYNCREATE(CFirstView, CView)  展开后为：

 CObject* PASCAL CFirstView::CreateObject()

  { return new CFirstView; }

 const CRuntimeClass CFirstView::classCFirstView = {

  " CFirstView ", sizeof(class CFirstView), 0xFFFF, CFirstView::CreateObject,    (CRu

ntimeClass*)(&CView::classCView), NULL };

 CRuntimeClass* CFirstView::GetRuntimeClass() const

  { return (CRuntimeClass*)(& CFirstView::classCFirstView); }

（3）主框架类

DECLARE_DYNCREATE(CMainFrame)  展开后为：

public: 

 static const CRuntimeClass classCMainFrame;

 virtual CRuntimeClass* GetRuntimeClass() const;

 static CObject* PASCAL CreateObject();

 

IMPLEMENT_DYNCREATE(CMainFrame, CFrameWnd)  展开后为：

 CObject* PASCAL CMainFrame::CreateObject()

  { return new CMainFrame; }

 const CRuntimeClass CMainFrame::classCMainFrame = {

  "CMainFrame", sizeof(class CMainFrame), 0xFFFF, CMainFrame::CreateObject,    (CRu

ntimeClass*)(& CFrameWnd::classCFrameWnd), NULL };

 CRuntimeClass* CMainFrame::GetRuntimeClass() const

  { return (CRuntimeClass*)(&CMainFrame::classCMainFrame); }

 

  这些宏首先在你的定义文件中定义一个以class+类名为名字的静态变量。然后定义一个返回这个静态变量的函数GetRuntimeClass并在实现文件中实现之。最后定义并实现一个创建对象的函数CreateObject。

 

好了，我们现在就来看看CSingleDocTemplate对象的构造函数做了些什么：下面是他的实现

CSingleDocTemplate::CSingleDocTemplate(UINT nIDResource,

 CRuntimeClass* pDocClass, CRuntimeClass* pFrameClass,

 CRuntimeClass* pViewClass)

  : CDocTemplate(nIDResource, pDocClass, pFrameClass, pViewClass)

{

 m_pOnlyDoc = NULL;

}

它主要是初始化他的父类CDocTemplate,CDocTemplate做了些什么？如下：

{

<1>把资源ID及文档、框架、视图的三个CRuntimeClass结构的静态成员的地址(也就是传进来的四个参数) 保存了起来。

<2>LoadTemplate();///为指定的文档模板对象装载资源

}

至此这个new语句总算讲完了。

第二节：AddDocTemplate(pDocTemplate);

下面是他的实现函数

void CWinApp::AddDocTemplate(CDocTemplate* pTemplate)

{

 if (m_pDocManager == NULL)

m_pDocManager = new CDocManager; /*创建一个文档管理类，对于单文档常常只有一个文档模板用CDocManager类并不是很重要,我们可以忽略这句*/

 m_pDocManager->AddDocTemplate(pTemplate); /*把文档模板指针保存在CDocManager实例中由CDocManager去管理他,我们只要知道有这个事就行了*/

}

第三节：ProcessShellCommand(cmdInfo)

   这个函数发送的一个命令就是FileNew其他的暂时不管他，其实所有的文档类，框架类，视图类都是在这个函数中创建的，在第一段中已经讲到应用程序类将上三个类的CRuntimeClass一个静态成员地址保存起来了，关于CRuntimeClass结构的具体功能参照MSDN。

ProcessShellCommand描述如下:

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:

  if (!OpenDocumentFile(rCmdInfo.m_strFileName))

   bResult = FALSE;

  break;

……………………………….///还有很多消息处理略去

 }

 return bResult;

}

第一段AfxGetApp()->OnCmdMsg(…)

AfxGetApp()->OnCmdMsg主要是派发命令消息，跟我们关系最大的消息是菜单命令ID_FILE_NEW，下面讲述他的处理函数OnFileNew

第二段OnFileNew();

 OnFileNew只是简单的调用文档管理对象的同名函数,他的描述如下：

void CWinApp::OnFileNew()

{

 if (m_pDocManager != NULL)

  m_pDocManager->OnFileNew();///只是调用CDocManager::OnFileNew

}

文档管理类的OnFileNew去掉一些没用的东西后实现如下：

void CDocManager::OnFileNew()

{

 CDocTemplate* pTemplate = (CDocTemplate*)m_templateList.GetHead();/*获得第一个文档模板,对于单文档只有一个文档模板*/

 if (m_templateList.GetCount() > 1)///对单文档这段没用

 {

  CNewTypeDlg dlg(&m_templateList);

  int nID = dlg.DoModal();

  if (nID == IDOK)

   pTemplate = dlg.m_pSelectedTemplate;

  else

   return;     /// none - cancel operation

 }

 pTemplate->OpenDocumentFile(NULL);/*其实是调用CSingleDocTemplate::OpenDocumentFile函数下面祥述这里,因为在CDocTemplate 类中这个函数是一个纯虚函数*/

}

下面简述pTemplate->OpenDocumentFile(NULL);这个函数，

这是最重要的一个函数,他执行了如下6个步骤：

 

<1>pDocument = CreateNewDocument();///创建一个新文档

   {

CDocument* pDocument = (CDocument*)m_pDocClass->CreateObject();/*这是才真正的创建文档对象，这里创建的文档对象就是上面RUNTIME_CLASS(CFirstDoc),中的对象这是MFC开发人员想出来的一种运行时创建对象的方法，应该说比较不错的,不知道C++Builder的是怎样构造的。*/

  AddDocument(pDocument);  ///把创建的对象指针记录下来，以后还要用的。

}

<2> pFrame = CreateNewFrame(pDocument, NULL);  /*根据新文档指针创建新文档框架,这个比较重要下一段描述*/

<3>SetDefaultTitle(pDocument);  ///设置缺省标题，不重要的

<4>pDocument->OnNewDocument()   ///清除老文档内容

{

 DeleteContents();   ///删除原来的内容而不管是否存盘

 SetModifiedFlag(FALSE);   ///清除曾经修改过的标记

}

<5>pThread->m_pMainWnd = pFrame;  ///框架窗口作为的指针作为主窗口的指针

<.6>InitialUpdateFrame(pFrame, pDocument, bMakeVisible);   /*使框架中的视图窗口接受到OnInitialUpdat的调用,并作原始更新。*/

 

至此第一段的OnFileNew函数总算讲完。下面讲<2> CreateNewFrame函数

CreateNewFrame是CDocTemplate的成员函数如下3个步骤：

<2.1>CCreateContext context;    ///创建CcreateContext对象.也就是我们重载LoadFrame函数的那个CcreateContext的来源*/

context.m_pCurrentFrame = pOther;  ///保存当前框架，一般为NULL

context.m_pCurrentDoc = pDoc;     ///保存文档对象指针

context.m_pNewViewClass = m_pViewClass;  ///保存视图对象指针

context.m_pNewDocTemplate = this;       ///保存文档模板的指针。

<2.2>CFrameWnd* pFrame = (CFrameWnd*)m_pFrameClass->CreateObject(); ///真正创建框架的对象

<2.3>pFrame->LoadFrame(m_nIDResource,WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE,  

   NULL, &context)   ///加载资源，这是最重要的，下面讲述

{

<2.3.1> GetIconWndClass(dwDefaultStyle, nIDResource)   ///加载资源并注册窗口

 {

  AfxFindResourceHandle

  ::LoadIcon  ///加载光标资源

  CREATESTRUCT cs;  ///创建一个CREATESTRUCT结构实例

  PreCreateWindow(cs);   /*调用窗口预创建函数，这个函数我们可以重载的

  根据cs调用 AfxRegisterWndClass注册框架窗口*/

}

<2.3.2> Create(…)  ///创建框架窗口,后面祥述，此处暂时不讲。

<2.3.3> m_hMenuDefault = ::GetMenu(m_hWnd);  ///获取并保存菜单句柄

<2.3.4> LoadAccelTable(MAKEINTRESOURCE(nIDResource));  ///装载加速键表

}

  下面讲Create函数，如下4个步骤：

  <2.3.2.1>hMenu = ::LoadMenu(hInst, lpszMenuName);  ///加载菜单

<2.3.2.2>CREATESTRUCT cs;  ///创建一个CREATESTRUCT结构实例

cs.lpCreateParams = lpParam;  ///(