MFC教程_ MFC对象的创建

MFC对象的创建

前面几章介绍了MFC的核心概念和思想，即介绍了MFC对Windows对象的封装方法和特点；MFC对象的动态创建、序列化；MFC消息映射机制。

现在，考查MFC的应用程序结构体系，即以文档-视为核心的编程模式。学习本章，应该弄清楚以下问题：

MFC中诸多MFC对象的关系：应用程序对象，文档对象，边框窗口对象，文档边框窗口对象，视对象，文档模板对象等。

MFC对象的创建和销毁：由什么对象创建或销毁什么对象，何时创建，何时销毁？

MFC提供了那些接口来支持其编程模式？

MFC对象的关系

创建关系

这里讨论应用程序、文档模板、边框窗口、视、文档等的创建关系。图5-1大略地表示了创建顺序，但表5-1更直接地显示了创建与被创建的关系。

表5-1 MFC对象的创建关系

创建者	被创建的对象
应用程序对象	文档模板
文档模板	文档
文档模板	边框窗口
边框窗口	视

交互作用关系

应用程序对象有一个文档模板列表，存放一个或多个文档模板对象；文档模板对象有一个打开文档列表，存放一个或多个已经打开的文档对象；文档对象有一个视列表，存放显示该文档数据的一个或多个视对象；还有一个指针指向创建该文档的文档模板对象；视有一个指向其关联文档的指针，视是一个子窗口，其父窗口是边框窗口（或者文档边框窗口）；文档边框窗口有一个指向其当前活动视的指针；文档边框窗口是边框窗口的子窗口。

Windows 管理所有已经打开的窗口，把消息或事件发送给目标窗口。通常，命令消息发送给主边框窗口。

图5-2大略地表示了上述关系：

MFC提供了一些函数来维护这些关系。

表5-2列出了从一个对象得到相关对象的方法。

表5-2 从一个对象得到另一个对象的方法

本对象	要得到的对象	使用的成员函数
CDocument对象	视列表	GetFirstViewPosition GetNextView
CDocument对象	文档模板	GetDocTemplate
CView对象	文档对象	GetDocument
CView对象	边框窗口	GetParentFrame
CMDIChildWnd或 CFrameWnd对象	活动视	GetActiveView
CMDIChildWnd或 CFrameWnd对象	活动视的文档	GetActiveDocument
CMDIFrameWnd对象	活动文档边框窗口	MDIGetActive

表5-3 从一个对象通知另一个对象的方法：

本对象	要通知的对象/动作	使用的成员函数
CView对象	通知文档更新所有视	CDocument::UpdateAllViews
CDocument对象	更新一个视	CView::OnUpdate
CFrameWnd或 CMDIFrameWnd对象	通知一个视为活动视	CView::OnActivateView
CFrameWnd或 CMDIFrameWnd对象	设置一个视为活动视	SetActivateView

可以通过表5-2得到相关对象，再调用表5-3中相应的函数。例如：视在接受了新数据或者数据被修改之后，使用表5-2中的函数GetDocument得到关联文档对象，然后调用表5-3中的文档函数UpdateAllViews更新其他和文档对象关联的视。

在表5-2和表5-3中，CView对象指CView或派生类的实例；成员函数列中如果没有指定类属，就是第一列对象的类的成员函数。

MFC提供的接口

MFC编程就是把一些应用程序特有的东西填入MFC框架。MFC提供了两种填入的方法：一种就是使用前一章论述的消息映射，消息映射给应用程序的各种对象处理各种消息的机会；另一种就是使用虚拟函数，MFC在实现许多功能或者处理消息、事件的过程中，调用了虚拟函数来完成一些任务，这样就给了派生类覆盖这些虚拟函数实现特定处理的机会。

下面两节将列出两类接口，有两个目的：一是为了让读者获得整体印象，二是后文将涉及到或者讨论其中的许多函数时，不显得突兀。

虚拟函数接口

几乎每一个MFC类都定义和使用了虚拟成员函数，程序员可以在派生类中覆盖它们。一般，MFC提供了这些函数的缺省实现，所以覆盖函数应该调用基类的实现。这里给出一个MFC常用虚拟函数的总览表(见表5-4)，更详细的信息或它们的缺省实现动作参见MFC文档。由于基类的虚拟函数被派生类继承，所以在派生类中不作重复说明。

覆盖基类的虚拟函数可以通过ClassWizard进行，不过，并非所有的函数都可以这样，有的必须手工加入函数声明和实现。

表5-4 常见MFC类的虚拟函数接口

类	虚拟函数	覆盖的目的和功能
CCmdTarget	OnCmdMsg	发送、派发命令消息
CCmdTarget	OnFinalRelease	OLE用途，引用为0时作清理工作
CWinThread	ExitInstance	在线程退出时作清理工作
	InitInstance	在线程开始时作初始化
	OnIdle	执行thread-specific idle-time处理
	PreTranslateMessage	在消息送给Windows函数TranslateMessage and DispatchMessage.之前进行消息过滤
	IsIdleMessage	检查是否是某个特别的消息
	ProcessWndProcException	截获线程消息/命令处理中的例外
	ProcessMessageFilter	线程消息过滤
	Run	实现线程特定的消息循环
CWinApp	HideApplication	关闭所有的窗口之前隐藏应用程序
CWinApp	CloseAllDocument	退出程序之前关闭所有文档
转下页

续表
	SaveModifiedDocument	框架窗口关闭时用来保存文档
	DoMessageBox	实现客户化的messagebox
	DoWaitCursor	关闭或打开等待光标
	OnDDeCommand	响应DDE命令
	WinHelp	调用WinHelp函数
CWnd	WindowProc	提供一个窗口过程
	DefWindowProc	为应用程序不处理的消息提供缺省处理
	PostNcDestroy	在窗口销毁之后被消息处理函数OnNcDestroy调用
	OnNotify	处理通知消息WM_NOTIFY
	OnChildNotify	父窗口调用它给控制子窗口一个机会来处理通知反射消息
	DoDataExchange	Updata调用它来进行对话框数据交换和验证
CFrameWnd	GetMessageBar	返回一个指向框架窗口的状态条的指针
	OnCreateClient	创建框架的客户窗口
	OnSetPreviewMode	设置程序的主框架窗口进入或退出打印预览模式
	NegotiateBorderSpace	协调边框窗口的边框空间的大小(OLE用途)
CMDIFrameWnd	CreateClient	创建CMDIFrameWnd的MDICLIENT窗，被CWnd的消息处理函数OnCreate调用.
转下页

续表
	GetWindowMenuPopup	返回窗口的弹出式菜单
CDialog	OnInitDialog	对话框窗口的初始化
	OnSetFont	设置对话框控制的文本字体
	OnOK	模式对话框的OK按钮按下后进行的处理
	OnCancel	模式对话框的CANCEL按钮按下后进行的处理
CView	IsSelected	测试是否有一个文档被选择(OLE支持)
	OnActivateView	视窗口激活时调用
	OnActivateFrame	当包含视窗口的框架窗口变成活动或非活动窗口时调用
	OnBeginPrinting	打印工作开始时调用，用来分配GDI资源
	OnDraw	用来屏幕显示、打印、打印预览文档内容
	OnEndPrinting	打印工作结束时调用，释放GDI资源
	OnEndPrintPreview	退出打印预览模式时调用
	OnPrepareDC	OnDraw或OnPrint之前调用，用来准备设备描述表
	OnPreparePrinting	文档打印或者打印预览前调用，可用来初始化打印对话框
	OnPrint	用来打印或打印预览文档
	OnUpdate	用来通知一个视的关联文档内容已经变化
CDocTemplate	MatchDocType	确定文档类型和文档模板匹配时的可信程度
转下页

续表
	CreateNewDocument	创建一个新的文档
	CreateNewFrame	创建一个包含文档和视的框架窗口
	InitialUpdateFrame	初始化框架窗口，必要时使它可见
	SaveAllModified	保存所有和模板相关的而且修改了的文档
	CloseAllDocuments	关闭所有和模板相关的文档
	OpenDocumentFile	打开指定路径的文件
	SetDefaultTitle	设置文档窗口缺省显示的标题
CDocument	CanCloseFrame	在关闭显示该文档的边框窗口之前调用
	DeleteContents	用来清除文档的内容
	OnChangedViewList	在与文档关联的视图被移走或新加入时调用
	OnCloseDocument	用来关闭文档
	OnNewDocument	用来创建新文档
	OnOpenDocument	用来打开文档
	OnSaveDocument	以来保存文档
	ReportSaveLoadException	处理打开、保存文档操作失败时的例外
	GetFile	返回一个指向Cfile对象的指针
	ReleaseFile	释放一个文件以便其他应用程序可以使用
	SaveModified	用来询问用户文档是否需要保存
	PreCloseFrame	在框架窗口关闭之前调用

消息映射方法和标准命令消息

窗口对象可以响应以“WM_”为前缀的标准Windows消息，消息处理函数名称以“ON”为前缀。不同类型的Windows窗口处理的Windows消息是有所不同的，因此，不同类型的MFC窗口实现的消息处理函数也有所不同。例如，多文档边框窗口能处理WM_MDIACTIVATE消息，其他类型窗口就不能。程序员从一定的MFC窗口派生自己的窗口类，对感兴趣的消息，覆盖基类的消息处理函数，实现自己的消息处理函数。

所有的命令目标（CCmdTarger或导出类对象）可以响应命令消息，程序员可以指定应用程序对象、框架窗口对象、视对象或文档对象等来处理某条命令消息。一般地，尽量由与命令消息关系密切的对象来处理，例如隐藏/显示工具栏由框架窗口处理，打开文件由应用程序对象处理，数据变化的操作由文档对象处理。

对话框的控制子窗口可以响应各类通知消息。

对于命令消息，MFC实现了一系列标准命令消息处理函数。标准命令ID在afxres.h中定义。表5-5列出了MFC标准命令的实现，从ID或者函数名可以大致地看出该函数的目的、功用，具体的实现有的后续章节会讲解，详细参见MFC技术文档。

程序员可以自己来处理这些标准消息，也可以通过不同的类或从不同的类导出自己的类来处理这些消息，不过最好遵循MFC的缺省实现。比如处理ID_FILE_NEW命令，最好由CWinApp的派生类处理。

表5-5 标准命令消息处理函数

ID	函数	实现函数的类
ID_FILE_NEW	OnFileNew	CWinApp
ID_FILE_OPEN	OnFileOpen	CWinApp
ID_FILE_CLOSE	OnFileClose	CDocument
ID_FILE_SAVE	OnFileSave	CDocument
ID_FILE_SAVE_AS	OnFileSaveAs	CDocument
ID_FILE_SAVE_COPY_AS	OnFileSaveCopyAs	COleServerDoc
ID_FILE_UPDATE	OnUpdateDocument	COleServerDoc
ID_FILE_PAGE_SETUP	OnFilePrintSetup	CWinApp
转下页

续表
ID_FILE_PRINT	OnFilePrint	CView
ID_FILE_PRINT_PREVIEW	OnFilePrintPreview	CView
ID_FILE_MRU_FILE1...FILE16	OnUpdateRecentFileMenu	CWinApp
ID_EDIT_CLEAR		CView没有实现，
ID_EDIT_CLEAR_ALL		但是，如果有实现
ID_EDIT_COPY		函数，就是派生类
ID_EDIT_CUT		CEditView的
ID_EDIT_FIND		实现函数
ID_EDIT_PASTE_LINK
ID_EDIT_PASTE_SPECIAL
ID_EDIT_REPEAT
ID_EDIT_REPLACE
ID_EDIT_SELET_ALL
ID_EDIT_UNDO
ID_WINDOW_NEW	OnWindowNew	CMDIFrameWnd
ID_WINDOW_ARRANGE	OnMDIWindowCmd	CMDIFrameWnd
ID_WINDOW_CASCADE
ID_WINDOW_TILE_HORZ
ID_WINDOW_TILE_VERT
ID_WINDOW_SPLIT		CSplitterWnd
ID_APP_ABOUT
ID_APP_EXIT	OnAppExit	CWinApp
ID_HELP_INDEX	OnHelpIndex	CWinApp
ID_HELP_USING	OnHelpUsing	CWinApp
ID_CONTEXT_HELP	OnContextHelp	CWinApp
转下页

续表
ID_HELP	OnHelp	CWinApp
ID_DEFAULT_HELP	OnHelpIndex	CWinApp
ID_NEXT_PANE	OnNextPaneCmd	CSplitterWnd
ID_PREV_PANE	OnNextPaneCmd	CSplitterWnd
ID_OLE_INSERT_NEW
ID_OLE_EDIT_LINKS
ID_OLE_VERB_FIRST...LAST
ID_VIEW_TOOLBAR		CFrameWnd
ID_VIEW_STATUS_BAR		CFrameWnd
ID_INDICATOR_CAPS ID_INDICATOR_NUM ID_INDICATOR_SCRL ID_INDICATOR_KANA	OnUpdateKeyIndicator	CFrameWnd

MFC对象的创建过程

应用程序使用MFC的接口是把一些自己的特殊处理填入MFC框架，这些处理或者在应用程序启动和初始化的时候被调用，或者在程序启动之后和用户交互的过程中被调用，或者在程序退出和作清理工作的时候被调用。这三个阶段中，和用户交互阶段是各个程序自己的事情，自然都不一样，但是程序的启动和退出两个阶段是MFC框架所实现的，是MFC框架的一部分，各个程序都遵循同样的步骤和规则。显然，清楚MFC框架对这两个阶段的处理是很有必要的，它可以帮助深入理解MFC框架，更好地使用MFC框架，更有效地实现应用程序特定的处理。

MFC程序启动和初始化过程就是创建MFC对象和Windows对象、建立各种对象之间的关系、把窗口显示在屏幕上的过程，退出过程就是关闭窗口、销毁所创建的Windows对象和MFC对象的过程。所以，下面要讨论几种常用MFC对象的结构，它们是构成一个文档-视模式应用程序的重要部件。

应用程序中典型对象的结构

本节将主要分析应用程序对象、文档对象、文档模板等的数据结构。通过考察类的结构，特别是成员变量结构，弄清它的功能、目的以及和其他类的关系；另外，在后续有关分析中必定会提到这些成员变量，这里先作个说明，到时也不会显得突兀。

下面几节以表格的形式来描述各个类的成员变量。表格中，第一列打钩的表示是MFC类库文档有说明的；没打钩的在文档中没有说明，如果是public，则可以直接访问，但随着MFC版本的变化，以后MFC可能不支持这些成员；第二列是访问属性；第三列是成员变量名称；第四列是成员变量的数据类型；第五列是对成员变量的功能、用途的简要描述。

应用程序类的成员变量

应用程序对象的数据成员表由两部分组成，第一部分是CWinThread的成员变量，如表5-6所示，CWinApp继承了CWinThread的数据成员。第二部分是CWinApp自己定义的成员变量，如表5-7所示。

表5-6 CwinThread的成员变量

	访问限制	变量名称	类型	解释
√	public	m_bAutoDelete	BOOL	指定线程结束时是否销毁线程对象本身
√	public	m_hThread	HANDLE	当前线程的句柄
√	public	m_nThreadID	UINT	当前线程的ID
√	public	m_pMainWnd	CWnd*	指向应用程序主窗口的指针
√	public	m_pActiveWnd	CWnd*	当OLE SERVER就地激活时指向客户程序主窗口的指针
	public	m_msgCur	MSG	当前消息(MSG结构)
	public	m_pThreadParams	LPVOID	传递给线程开始函数的参数
	public	m_pfnThreadProc	函数指针1	线程开始函数，AFX_THREADPROC类型
	public	m_lpfnOleTermOrFreeLib	函数指针2	OLE用途，void (AFXAPI * fn)(BOOL,BOOL)
	public	m_pMessageFilter	指针	OLE消息过滤，指向COleMessageFilter对象
	protected	m_ptCursorLast	CPoint	最新鼠标位置
	protected	m_nMsgLast	UINT	消息队列中最新接收到的消息

表5-7 CWinApp的成员变量

	访问限制	变量名称	类型	解释
√	public	m_pszAppName	LPCTSTR	应用程序名称
√	public	m_hInstance	HINSTANCE	标志应用程序当前实例句柄
√	public	m_hPrevInstance	HINSTANCE	32位程序设为空
√	public	m_lpCmdLine	LPTSTR	指向应用程序的命令行字符串
√	public	m_nCmdShow	int	指定窗口开始的显示方式
√	public	m_bHelpMode	BOOL	标识用户是否在上下文帮助模式
√	public	m_pszExeName	LPCTSTR	应用程序的模块名
√	public	m_pszHelpFilePath	LPCTSTR	应用程序的帮助文件名，缺省时同模块名
√	public	m_pszProfileName	LPCTSTR	应用程序的INI文件名，缺省时同应用程序名
√	public	m_pszRegistryKey	LPCTSTR	Register入口，如果不指定，使用INI文件。
	public	m_pDocManager;	CDocManager *	指向一个文档模板管理器
	protected	m_hDevMode	HGLOBAL	打印设备模式
	protected	m_hDevNames	HGLOBAL	打印设备名称
	protected	m_dwPromptContext	DWORD	被MESSAGE BOX覆盖的帮助上下文
	protected	m_nWaitCursorCount	int	等待光标计数
	protected	m_hcurWaitCursorRestore	HCURSOR	保存的光标，在等待光标之后恢复
	protected	m_pRecentFileList	指针	指向CRecentFileList对象，最近打开的文件列表
	public	m_atomApp	ATOM	DDE用途
	public	m_atomSystemTopic	m_atomApp	DDE用途
	public	m_nNumPreviewPages	UINT	缺省被打印的页面
	public	m_nSafetyPoolSize	size_t	理想尺寸
	public	m_lpfnDaoTerm	函数指针	DAO初始化设置时使用

CDocument的成员变量

表5-8 文档对象的属性。

访问限制	变量名称	类型	解释
protected	m_strTitle	CString	文档标题
protected	m_strPathName	CString	文档路径
protected	m_pDocTemplate	CDocTemplate*	指向文档模板的指针
protected	m_viewList	CPtrList	关联的视窗口列表
protected	m_bModified	BOOL	文档是否有变化、需要存盘
public	m_bAutoDelete	BOOL	关联视都关闭时是否删除文档对象
public	m_bEmbedded	BOOL	文档是否由OLE创建

文档模板的属性

表5-9列出了文档模板的成员变量，5-10列出了单文档模板的成员变量，5-11列出了多文档模板的成员变量。单、多文档模板继承了文档模板的成员变量。

表5-9 文档模板的数据成员

访问限制	变量名称	类型	解释
public	m_bAutoDelete	BOOL
public	m_pAttachedFactory	CObject *
public	m_hMenuInPlace	HMENU	就地激活时，OLE客户程序的菜单
public	m_hAccelInPlace	HACCEL	就地激活时，OLE客户程序的快捷键
public	m_hMenuEmbedding	HMENU
public	m_hAccelEmbedding	HACCEL
public	m_hMenuInPlaceServer	HMENU
public	m_hAccelInPlaceServer	HACCEL
protected	m_nIDResource	UINT	框架、菜单、快捷键等的资源ID
protected	m_nIDServerResource	UINT
public	m_nIDEmbeddingResource	UINT
public	m_nIDContainerResource	UINT
public	m_pDocClass	CRuntimeClass*	指向文档类的动态创建信息
public	m_pFrameClass	CRuntimeClass*	指向框架类的动态创建信息
public	m_pViewClass	CRuntimeClass*	指向视类的动态创建信息，由字符串m_nIDResource描述
public	m_pOleFrameClass	CRuntimeClass*	指向OLD框架类的动态创建信息
public	m_pOleViewClass	CRuntimeClass*
public	m_strDocStrings	CString	描述该文档类型的字符串

表5-10 单文档模板的成员变量

	访问限制	变量名称	类型	解释
	protected	m_pOnlyDoc	CDocment*	指向唯一的文档对象

表5-11 单文档模板的成员变量

访问限制	变量名称	类型	解释
public	m_hMenuShared	HMENU	该模板的MDI子窗口的菜单
public	m_hAccelTable	HACCEL	该模板的MDI子窗口的快捷键
protected	m_docList	CPtrList	该模板的文档列表
protected	m_nUntitledCount	UINT	用来生成文件名的数字，如”untitled0”的0。

WinMain入口函数
1. WinMain流程
  
  现在讨论MFC应用程序如何启动。
  
  WinMain函数是MFC提供的应用程序入口。进入WinMain前，全局应用程序对象已经生成。WinMain流程如图5-3所示。图中，灰色框是对被调用的虚拟函数的注释，程序员可以或必须覆盖它以实现MFC要求的或用户希望的功能；大括号所包含的图示是相应函数流程的细化，有应用程序对象App的初始化、Run函数的实现、PumpMessage的流程，等等。
  
  从图中可以看出：
  
  （1）一些虚拟函数被调用的时机
  
  对应用程序类（线程类）的InitIntance、ExitInstance、Run、ProcessMessageFilter、OnIdle、PreTranslateMessage来说，InitInstance在应用程序初始化时调用，ExitInstance在程序退出时调用，Run在程序初始化之后调用导致程序进入消息循环，ProcessMessageFilter、OnIdle、PreTranslateMessage在消息循环时被调用，分别用来过滤消息、进行Idle处理、让窗口预处理消息。
  
  （2）应用程序对象的角色
  
  首先，应用程序对象的成员函数InitInstance被WinMain调用。对程序员来说，它就是程序的入口点（真正的入口点是WinMain，但MFC向程序员隐藏了WinMain的存在）。由于MFC没有提供InitInstance的缺省实现，用户必须自己实现它。稍后将讨论该函数的实现。
  
  其次，通过应用程序对象的Run函数，程序进入消息循环。实际上，消息循环的实现是通过CWinThread::Run来实现的，图中所示的是CWinThread::Run的实现，因为CWinApp没有覆盖Run的实现，程序员的应用程序类一般也不用覆盖该函数。
  
  （3）Run所实现的消息循环
  
  它调用PumpMessage来实现消息循环，如果没消息，则进行空闲(Idle)处理。如果是WM_QUIT消息，则调用ExitInstance后退出消息循环。
  
  （4）CWinThread::PumpMessage
  
  该函数在MFC函数文档里没有描述，但是MFC建议用户使用。它实现获取消息，转换(Translate)消息，发送消息的消息循环。在转换消息之前，调用虚拟函数PreTranslateMessage对消息进行预处理，该函数得到消息目的窗口对象之后，使用CWnd的WalkPreTranslateTree让目的窗口及其所有父窗口得到一个预处理当前消息的机会。关于消息预处理，见消息映射的有关章节。如果是WM_QUIT消息，PumpMessage返回FALSE；否则返回TRUE。
2. MFC空闲处理

MFC实现了一个Idle处理机制，就是在没有消息可以处理时，进行Idle处理。Idle处理的一个应用是更新用户接口对象的状态。更新用户接口状态的内容见消息映射的章节。

空闲处理由函数OnIdle完成，其原型为BOOL OnIdle（int）。参数的含义是当前空闲处理周期已经完成了多少次OnIdle调用，每个空闲处理周期的第一次调用，该参数设为0，每调用一次加1；返回值表示当前空闲处理周期是否继续调用OnIdle。
MFC的缺省实现里，CWinThread::OnIdle完成了工具栏等的状态更新。如果覆盖OnIdle，需要调用基类的实现。
在处理完一个消息或进入消息循环时，如果消息队列中没有消息要处理，则MFC开始一个新的空闲处理周期；
当OnIdle返回FASLE，或者消息队列中有消息要处理时，当前的空闲处理周期结束。

从图5-3中Run的流程上可以清楚的看到MFC空闲处理的情况。

本节描述了应用程序从InitInstance开始初始化、从Run进入消息循环的过程，下面将就SDI应用程序的例子描述该过程中创建各个所需MFC对象的流程。

SDI应用程序的对象创建

如前一节所述，程序从InitInstance开始。在SDI应用程序的InitInstance里，至少有以下语句：

//第一部分，创建文档模板对象并把它添加到应用程序的模板链表

CSingleDocTemplate* pDocTemplate;

pDocTemplate = new CSingleDocTemplate(

IDR_MAINFRAME,

RUNTIME_CLASS(CTDoc),

RUNTIME_CLASS(CMainFrame), // main SDI frame window

RUNTIME_CLASS(CTView));

AddDocTemplate(pDocTemplate);

//第二部分，动态创建文档、视、边框窗口等MFC对象和对应的Windows对象

//Parse command line for standard shell commands, DDE, file open

CCommandLineInfo cmdInfo;

ParseCommandLine(cmdInfo);

// Dispatch commands specified on the command line

if (!ProcessShellCommand(cmdInfo))

return FALSE;

//第三部分，返回TRUE，WinMain下一步调用Run开始消息循环，

//否则，终止程序

return TRUE;

对于第二部分，又可以分解成许多步骤。

下面将解释每一步。
1. 文档模板的创建
  
  第一步是创建文档模板。
  
  文档模板的作用是动态创建其他MFC对象，它保存了要动态创建类的动态创建信息和该文档类型的资源ID。这些信息保存在文档模板的成员变量里：m_nIDResource(资源ID)、m_pDocClass(文档类动态创建信息)、m_pFrameClass(边框窗口类动态创建信息)、m_pViewClass(视类动态创建信息)。
  
  资源ID包括菜单、像标、快捷键、字符串资源的ID，它们都使用同一个ID值，如IDR_MAINFRAME。其中，字符串资源描述了文档类型，由七个被“\n”分隔的子字符串组成，各个子串可以通过CDocTemplate的成员函数GetDocString(CString& rString, enum DocStringIndex index)来获取。DocStringIndex是CDocTemplate类定义的枚举变量以区分七个子串，描述如下（英文是枚举变量名称）。
  
  WindowTitle 应用程序窗口的标题。仅仅对SDI程序指定。
  
  DocName 用来构造缺省文档名的字符串。当用File菜单的菜单项new创建新文档时，缺省文档名由该字符串加一个数字构成。如果空，使用“unitled”。
  
  FileNewName 文档类型的名称，在打开File New对话框时显示。
  
  FilterName 匹配过滤字符串，在File Open对话框用来过滤要显示的文件。如果不指定，File Open对话框的文件类型(file style)不可访问。
  
  FilterExt 该类型文档的扩展名。如果不指定，则不可访问对话框的文件类型(File Style)。
  
  RegFileTypeId 文档类型在Windows 注册库中的存储标识。
  
  RegFileTypeName 文档类型在Windows 注册库中的类型名称。
  
  文档模板被应用程序对象创建和管理。应用程序类CWinApp有一个CDocManager类型的成员变量m_pDocManager，通过该变量来管理应用程序的文档模板列表，把一些相关的操作委派给CDocManager对象处理。
  
  CDocManager使用CPtrList类型的m_templateList变量来存储文档模板，并提供了操作文档模板列表的系列函数。
  
  从语句pDocTemplate = new CSingleDocTemplate(…)可以看出应用程序对象创建模板时传递一个资源ID和三个类的动态创建信息给它：
  
  IDR_MAINFRAME，资源ID
  
  RUNTIME_CLASS(CTDoc)，文档类动态创建信息
  
  RUNTIME_CLASS(CMainFrame),边框窗口类动态创建信息
  
  RUNTIME_CLASS(CTView)，视类动态创建信息
  
  文档模板对象接收这些信息并把它们保存到对应的成员变量里头。然后AddDocTemplate实际调用m_pDocManager->AddDocTemplate，把创建的模板对象加入到文档模板管理器的模板列表中，也就是应用程序对象的文档模板列表中。
2. 文件的创建或者打开

第二步是创建或者打开文件。

对于SDI程序，MFC对象的动态创建过程是在创建或者打开文件中发生的。但是为什么没有看到文件操作相关的语句呢？

CCommandLineInfo

首先，需要弄清楚类CcommandLineInfo，它是用来处理命令行信息的类，CWinApp::PareCommandLine调用CCommandLineInfo的成员函数ParseParm分析启动程序时的参数，把分析结果保存在CCommandLineInfo对象的成员变量里。CCommandLineInfo的定义如下：

class CCommandLineInfo : public CObject

{

BOOL m_bShowSplash;

BOOL m_bRunEmbedded;

BOOL m_bRunAutomated;

enum { FileNew, FileOpen, FilePrint, FilePrintTo, FileDDE,

AppUnregister, FileNothing = -1 } m_nShellCommand;

// not valid for FileNew

CString m_strFileName;

// valid only for FilePrintTo

CString m_strPrinterName;

CString m_strDriverName;

CString m_strPortName;

};

由上述定义可以看出，分析结果分几类：是否OLE激活；应该执行什么动作（FileNew、FileOpen等）；传递的参数（打开或打印的文件名，打印设备、端口等）。

当命令行空时，执行FileNew命令。原因在于CCommandLineInfo的缺省构造函数：

CCommandLineInfo::CCommandLineInfo()

{

m_bShowSplash = TRUE;

m_bRunEmbedded = FALSE;

m_bRunAutomated = FALSE;

m_nShellCommand = FileNew;//指定了SHELL命令操作

}

缺省构造把应该执行的动作指定为FileNew。
处理命令行命令

其次，分析 CWinApp::ProcessShellCommand(CCommandLineInfo& rCmdInfo)的流程，它处理命令行的命令，流程如图5-3所示。

图5-4第三层表示根据命令类型进一步调用的函数，都是CWinApp或者派生类的成员函数。对于FILEDDE类型没有进一步的调用。

命令类型是FILENEW时，调用的函数就是标准命令ID_FILE_NEW对应的处理函数OnFileNew；命令类型是FILEOPEN时调用的函数是OpenDocumentFile，标准命令ID_FILE_OPEN的处理函数OnFileOpen的工作实际上就是由OpenDocumentFile完成的。函数FileNew、OpenDocumentFile导致了窗口、文档的创建。
OnFileNew

接着，分析 CWinApp::OnFileNew流程，如图5-5所示。

图5-5的说明：

应用程序对象得到文档模板管理器指针，调用文档模板管理器的成员函数OnFileNew(m_pDocManager->OnFileNew())；模板管理器获取文档模板对象指针，调用文档模板对象的OpenDocumentFile 函数（pTemplate->OpenDocumentFile(NULL)）。如果模板管理器发现有多个文档模板，就弹出一个对话框让用户选择文档模板。这里和后面的图解中类似于CWinApp::、CDocManager::、CDocTemplate::等的函数类属限制并不表示直接源码中有这样的限制，而是通过指针或者指针的动态约束可以认定调用了某个类的成员函数，其正确性仅仅限于本书图解的MFC的缺省实现。

如图5-5所示，程序员可以覆盖有关虚拟函数或命令处理函数：如果程序员在自己的应用程序类中覆盖了OnFileNew，则可以实现完全不同的处理流程；一般情况下，不会从文档模板类派生新类，如果派生的话，可以覆盖CDocTemplate的虚拟函数。
OnFileOpen

分析了 OnFileNew后，现在分析CWinApp::OnFileOpen()，其流程如图5-6所示。

CWinApp::OnFileOpen和OnFileNew类似，不过，第二步须得到一个要打开的文件的名称，第三步调用的是应用程序对象的OpenDocumentFile，而不是文档模板对象的该函数。
应用程序对象的OpenDocumentFile

分析应用程序的打开文档函数： CWinApp::OpenDocumentFile(LPCSTR name)，其流程如图5-7所示。

　

应用程序对象把打开文件操作委托给文档模板管理器，后者又委托给文档模板对象来执行。如果是SDI程序，则委托给单文档对象；如果是MDI程序，则委托给多文档对象──这是由指针所指对象的实际类型决定的，因为该函数是一个虚拟函数。
文档模板的OpenDocumentFile

不论是FileNew还是FileOpen，最后的操作都归结到由文档模板来打开文件（文件名空则创建文件）。

CSingleDocTemplate::OpenDocumentFile(lpcstr name，BOOL visible)的流程见图5-8。有一点需要指出的是：创建了一个文档对象，并不等于打开了一个文档(件)或者创建了一个新文档(件)。

图5-8显示的流程大致可以描述如下：

如果已经有文档打开，则保存当前的文档；否则，文档对象还没有创建，需要创建一个新的文档对象。因为这时边框窗口还没有生成，所以还要创建边框窗口对象（MFC对象）和边框窗口。MFC边框窗口对象动态创建，HWND边框窗口由LoadFrame创建。MFC边框窗口被创建时，CFrameWnd的缺省构造函数被调用，它把正创建的对象(this所指)加入到模块-线程状态的边框窗口列表m_frameList之首。

边框窗口创建过程中由CreateView动态创建MFC视对象和HWND视窗口。

接着，如果没有指定要打开的文件名，则创建一个新的文件；否则，则打开文件，并使用序列化机制读入文件内容。

通过上述过程，动态地创建了MFC边框窗口对象、视对象、文档对象以及对应的Windows对象，并填写了有关对象的成员变量，建立起这些MFC对象的关系。
打开文件过程中所涉及的消息处理函数和虚拟函数

图5-8描述的整个过程中系列消息处理函数和虚拟函数被调用。例如：在Windwos边框窗口和视窗口被创建时会产生WM_CREATE等消息，导致OnCreate等消息处理函数的调用，CFrameWnd和CView都覆盖了该函数，所以在边框窗口和视窗口的创建中，同样的消息调用了不同的处理函数CFrameWnd::OnCreate和CView::OnCreate。

图5-8涉及的几个虚拟函数的流程分别由图5-9、图5-10图解。图5-9表示CDocument的OnNewDocument的流程；图5-10表示CDocument的OpenDocument的流程。这两个函数分别在创建新文档或者打开一个文档时被调用。从流程可以看出，对于OpenDocument函数，MFC的缺省实现主要用来设置修改标识、序列化读入打开文档的内容。图5-10显示了序列化的操作过程：

首先，使用文档对象打开或者创建的文件句柄创建一个用于读出数据的CArchive对象loadarchive；然后使用它通过Serialize进行序列化操作，完毕，CArchive对象被自动销毁，文件句柄被关闭。

从这些图中可以看到何时、何处调用了什么消息处理函数和虚拟函数，这些函数用来作了什么事情。必要的话，程序员可以在派生类覆盖它们。

在创建工作完成之后，进行初始化，使用文档对象的数据来更新视和显示窗口。

至此，本节描述了MFC的SDI程序从分析命令行到创建或打开文件的处理过程，文档对象已经动态创建。总结如下：

命令行分析→应用程序的FileNew→文档模板的OpenDocumentFile(NULL)→文档的OnNewDocument

命令行分析→应用程序的FileOPen→文档模板的OpenDocumentFile(filename)→文档的OpenDocument

边框窗口对象、视对象的动态创建和对应 Windows对象的创建从LoadFrame开始，这些将在下一节论述。

SDI边框窗口的创建

第三步是创建SDI边框窗口。

图5-8已经分析了创建SDI边框窗口的时机和创建方法，下面，从LoadFrame开始分析整个窗口创建过程。

CFrameWnd::LoadFrame

CFrameWnd::LoadFrame的流程如图5-11所示，其原型如下：

BOOL CFrameWnd::LoadFrame(UINT nIDResource,

DWORD dwDefaultStyle,

CWnd* pParentWnd,

CCreateContext* pContext)

第一个参数是和该框架相关的资源ID，包括字符串、快捷键、菜单、像标等；

第二个参数指定框架窗口的“窗口类”和窗口风格；此处创建SDI窗口时和缺省值相同，为WS_OVERLAPPEDWINDOW | FWS_ADDTOTITLE；

第三个参数指定框架窗口的父窗口，此处和缺省值相同，为NULL；

第四个参数指定创建的上下文，如图5-8所示由CreateNewFrame生成了该变量并传递给LoadFrame。其缺省值为NULL。

创建上下文结构的定义：

struct CCreateContext

{

CRuntimeClass* m_pNewViewClass; //View的动态创建信息

CDocument*m_pCurrentDoc;//指向一文档对象，将和新创建视关联

//用来创建MDI子窗口的信息(C MDIChildFrame::LoadFrame使用)

CDocTemplate* m_pNewDocTemplate;

// for sharing view/frame state from the original view/frame

CView* m_pLastView;

CFrameWnd* m_pCurrentFrame;

};

这里，传递给LoadFrame的CCreateContext变量是：

(视的动态创建信息，新创建的文档对象，当前文档模板，NULL，NULL)。

其中，“新创建的文档对象”就是图 5-8中创建的那个文档对象。从此图中还可以看到，LoadFrame被CreateNewFrame调用，CreateNewFrame是文档模板的成员函数，被文档模板的成员函数OpenDocumentFile所调用，所以，LoadFrame间接地被文档模板调用，“当前文档模板”就是调用它的模板对象。顺便指出，对SDI程序来说是这样的，对MDI程序有所不同。“视的动态创建信息”也是文档模板传递过来的。

对图5-11的说明：

在创建边框窗口之前，先注册“窗口类”。LoadFrame注册了两个“窗口类”，一个为边框窗口，一个为视窗口。关于“窗口类”注册，见2.2.1节。

注册窗口类之后，创建边框窗口，并加载资源。创建边框窗口使用了CFrameWnd的Create虚拟函数，最终调用::CreateEx创建窗口。::CreateEx有11个参数，其最后一个参数就是文档模板传递给LoadFrame的CCreateContext类型的指针，该指针将被传递给窗口过程，进一步由Windows传递给OnCreate函数。顺便指出，创建完毕的边框窗口的窗口过程是统一的MFC窗口过程。

创建边框窗口时，发送消息WM_NCCREATE和WM_CREATE，导致对应的消息处理函数OnNcCreate和OnCreate被调用。CWnd提供了OnNcCreate处理非客户区创建消息，CFrameWnd没有处理该消息，但是提供了OnCreate处理消息WM_CREATE。OnCreate将创建视对象和视窗口。
CFrameWnd::OnCreate

按创建工作的进度，现在要讨论边框窗口创建消息（WM_CREATE）的处理了，处理函数是CFrameWnd的OnCreate，其原型如下：

int CFrameWnd::OnCreate(LPCREATESTRUCT lpcs)

其中，参数指向一个CreateStruct结构（关于CreateStruct的描述见4.4.1节），它包含了窗口创建参数的副本，也就是说CreaeEx窗口创建函数的11个参数被对应地复制到该结构的11个域，例如它的第一个成员就可以转换成CCreateContext类型的指针。

函数OnCreate处理WM_CREATE消息，它从lpcs指向的结构中分离出lpCreateParams并把它转换成为CCreateContext类型的指针pContext，然后，调用OnCreateHelp(lpcs，pContext)，把创建工作委派给它完成。

CFrameWnd::OnCreateHelp的原型如下，流程见图5-11。

int CFrameWnd::OnCreateHelp(LPCREATESTRUCT lpcs,

CCreateContext* pContext)

说明：由于CFrameWnd覆盖了消息处理函数OnCreate来处理WM_CREATE消息，所以CWnd就失去了处理该消息的机会，除非CFrameWnd::OnCreate主动调用基类的该消息处理函数。图5-11展示了对CWnd::OnCreate的调用。

在边框窗口被创建之后，调用虚拟函数OnCreateClient(lpcs，pContext)，它的缺省实现将创建视对象和视窗口。

最后，在状态栏显示“Ready”字样，调用RecalcLayout安排工具栏等的位置。关于WM_SETMESSAGESTRING消息和RecalcLayout函数，见工具栏有关13.2.3节。

到此，SDI的边框窗口已经被创建。下一节将描述视的创建。

视的创建

第四步，创建视。

如前一节所述，若CFrameWnd::OnCreateClient(lpcs，pContext)判断pContext包含了视的动态创建信息，则调用函数CreateView创建视对象和视窗口。CreateView的原型如下，其流程如图5-13所示。

CWnd * CFrameWnd::CreateView(CCreateContext* pContext, UINT nID)

其中：

第一个参数是创建上下文；

第二个参数是创建视 (子窗口)的ID，缺省是AFX_IDW_PANE_FIRST，这里等同缺省值。

说明：

CreateView调用了CWnd的Create函数创建HWND视窗口，视的子窗口ID是AFX_IDW_PANE_FIRST，父窗口是创建它的边框窗口。创建视窗口时的WM_CREATE、WM_NCCREATE消息分别被CView、CWnd的相关消息处理函数处理。处理情况如图5-13所述，这里不作进一步的讨论。

到此，文档对象、边框窗口对象、视窗口对象已经创建，文件已经打开或者创建，边框窗口、视窗口已经创建。现在，是显示和定位窗口、显示文档数据的时候了，这些通过调用CFrameWnd的虚拟函数InitialUpdateFrame完成，如图5-8所示。
窗口初始化

这是第五步，初始化边框窗口、视窗口等。

InitialUpdateFrame的原型如下：

void CFrameWnd::InitialUpdateFrame(CDocument* pDoc, BOOL bMakeVisible)

其中：

第一个参数是当前的文档对象；

第二个参数表示边框窗口是否应该可见并激活。

该函数是在文档模板的OpenDocumentFile中调用的，传递过来的第一个参数是刚才创建的文档，第二个参数是TRUE，见图5-8。

InitialUpdateFrame的处理过程参见图5-14，解释如下：

首先，如果当前边框窗口没有活动视，则获取ID为AFX_IDW_PANE_FIRST的视pView。如果该视不存在，则pView=NULL；否则(pView!=NULL)，调用成员函数SetActiveView(pView，FALSE)把它设置为活动视，参数2为FALSE表示并不通知它成为活动视（见图5-14）。

然后，如果InitialUpdateFrame的参数bMakeVisible为TRUE，则给所有边框窗口的视发送WM_INITIALUPDATE消息，通知它们在显示之前使用文档数据来初始化视。这导致视类的虚拟函数OnInitUpdate被调用，该函数又调用OnUpdate来完成初始化。其他子窗口（如状态栏、工具栏）也将收到WM_INITIALUPDATE消息，导致它们更新状态。

其三，调用pView->OnActivateFrame（WA_INACTIVE，this）给活动视（若存在的话）一个机会来保存当前焦点。这里，解释这个函数：

void CView::OnActivateFrame( UINT nState,CFrameWnd* pFrameWnd );

其中，参数1取值为WA_INACTIVE/WA_ACTIVE/WA_CLICKACTIVE，具体见消息WM_ACTIVE的解释；参数2指向被激活的框架窗口。

视对象通过该虚拟函数在它所属的边框窗口被激活或者失去激活时作一些特别的处理，例如，CFormView用它来保存或者恢复输入焦点控制。

其四，在OnActivateFrame之后，调用成员函数ActivateFrame激活框架窗口。这个过程将产生一个消息WM_ACTIVE（处理该消息的过程在下一节作解释)，它导致OnActiveTopLevel和OnActive被调用。接着，如果活动视非空，则调用成员函数OnActivateView激活它。

至此，参数bMakeVisible为TRUE时显示窗口的处理完毕。

最后，如果参数pDoc非空，则更新边框窗口计数，更新边框窗口的标题。更新边框窗口计数是为了在一个文档对应多个视的情况下，给显示同一文档的不同文档边框窗口编号，编号从1开始，保存在边框窗口的成员变量m_nWindow里。例如有两个边框对应一个文档tt1，则它们的标题分别为“tt1:1”、“tt1:2”。如果只有一个文档只对应一个边框窗口，则成员变量m_nWindow等于-1，标题不含编号，如“tt1”。

当然，对于SDI应用程序，不存在一个文档对应多个视的情况。上述情况是针对MDI应用程序而言的。SDI应用程序执行该过程时，相当于MDI程序的一个特例。

图 5-14涉及的一些函数由图5-15、5-15图解。

　

图5-14中的函数SetActiveView的图解如图5-15所示，其原型如下，：

void CFrameWnd::SetActiveView(CView * pViewNew, BOOL bNotify = TRUE)

其中：

参数1指向被设置的视对象，若非视类型的对象，则为NULL；

参数 2表示是否通知被设置的视。

图5-15中的变量m_pViewActive是CFrameWnd的成员变量，用来保存边框窗口的活动视。

图5-15中的流程可以概括为：Deactivate当前视（m_pViewActive非空时）；设置当前活动视；若参数bNotify为TRUE，通知pViewNew被激活。

图5-14中的函数ActivateFrame图解如图5-16所示，其原型如下，：

void CFrameWnd::ActivateFrame(UINT nCmdShow)

参数nCmdShow用来传递给CWnd::ShowWindow，指定显示窗口的方式。参数缺省为1，图5-14调用时设置为-1。

该函数用来激活(Activate)和恢复(Restore)边框窗口，使得它对用户可见可用。在初始化、OLE事件、DDE事件等需要显示边框窗口的地方调用。图5-16表示的MFC缺省实现是激活边框窗口并把它放到顶层。

程序员可以覆盖该虚拟函数ActivateFrame来控制边框窗口怎样被激活。

图5-16中的函数BringToTop是CFrameWnd内部使用的成员函数(protected)。它调用::BringWindowToTop把窗口放到Z轴上的顶层。

至此，边框窗口初始化的过程已经描述清楚，视的初始化见下一节。
视的初始化

第六步，在边框窗口初始化之后，初始化视。

如图5-14所示，视、工具条窗口处理消息WM_INITAILUPDATE(MFC内部消息)，完成初始化。这里只讨论视的消息处理函数，其原型如下：

void CView::OnInitialUpdate()

图5-14对该函数的注释说明了该函数的特殊之处。其缺省实现是调用OnUpdate(NULL, 0, NULL)更新视。可以覆盖OnInitialUpdate实现自己的初始化。

OnUpdate是一个虚拟函数，其原型如下：

void CView::OnUpdate(CView* pSender, LPARAM lHint, CObject* pHint)

其中：

参数1指向修改文档数据的视；若更新所有的视，设为NULL；

参数2是一个包含了修改信息的long型变量；

参数3指向一个包含修改信息的对象（从CObject派生的对象）。

参数2、参数3是在文档更新对应视的时候传递过来的。

该函数用来更新显示视窗口，反映文档的变化，在MFC中，它为函数CView::OnInitialUpdate和CDocument::UpdateAllViews所调用。其缺省实现是使整个客户区无效。在下一次收到WM_PAINT消息时，重绘无效区。

工具条的初始化见讨论第13章。
激活边框窗口(处理WM_ACTIVE)

第七步，在窗口初始化完成之后，激活并显示出来。

下面讨论边框窗口激活时的处理（对WM_ACTIVE的处理）。

WM_ACTIVE的消息参数

wParam的低阶word指示窗口是被激活还是失去激活：WA_ACTIVE，被鼠标点击以外的方法激活；WA_CLICKACTIVE，由鼠标点击激活；WA_INACTIVE，失去激活；

wParam的高阶word指示窗口是否被最小化；非零表示最小化；

lPararm表示将激活的窗口句柄(WA_INACTIVE)，或者将失去激活的窗口句柄(WA_CLICKACTIVE、WA_ACTIVE)。

在标准Windows消息处理的章节中，曾指出处理WM_ACTIVE消息时，先要调用一个函数_AfxHandleActivate，此函数的原型如下：

static void AFXAPI _AfxHandleActivate(CWnd* pWnd,

WPARAM nState,CWnd* pWndOther)

其中：

参数1是接收消息的窗口；

参数2是窗口状态，为WM_ACTIVE的消息参数wParam;

参数3是WM_ACTIVE的消息参数lParam表示的窗口。

_AfxHandleActivate是MFC内部使用的函数，声明和实现均在WinCore.CPP文件中。实现如下：

如果pWnd指向的窗口不是子窗口，而且pWnd和pWndOther窗口的顶级父窗口(TopLevelParent)不是同一窗口，则发送MFC定义的消息WM_ACTIVATETOPLEVEL给pWnd的顶级窗口，消息参数wParam是nState，消息参数lParam指向一个长度为二的数组，数组里存放pWnd和pWndOther所指窗口的句柄。否则，_AfxHandleActivate不作什么。

从这里可以看出：只有顶层的主边框窗口能处理WM_ACTIVE消息，事实上，Windows系统只会给顶层的非子窗口发送WM_ACTIVE消息。
WM_ACTIVATETOPLEVEL消息的处理

CWnd及派生类CFrameWnd实现了对WM_ACTIVATETOPLEVEL消息的处理，分别解释如下：

消息处理函数CWnd::OnActivateTopLevel如果失去激活，则取消工具栏的提示（TOOLTIP）。

消息处理函数CFrameWnd::OnActivateTopLevel调用CWnd的OnActivateTopLevel；如果接收WM_ACTIVE消息的窗口是线程主窗口，则使得其活动的视窗口变成非活动的（OnActive(FALSE, pActiveView,pActiveView)。

从这里可以知道，在顶层窗口接收到WM_ACTIVE消息后，MFC会进行一些固定的处理，然后才调用WM_ACTIVE消息处理函数。
WM_ACTIVE消息的处理

在_AfxHandleActivate和WM_ACTIVATETOPLEVEL消息处理完之后，才是对WM_ACTIVE的处理。CWnd和CFrameWnd都实现了消息处理。

CWnd的消息处理函数：

void CWnd::OnActive(UINT nState, CWnd* pWndOther, BOOL bMinimized)

其中：

参数1取值为WA_INACTIVE/WA_ACTIVE/WA_CLICKACTIVE；

参数2指向激活或者失去激活的窗口，具体同WM_ACTIVE消息；

参数3表示是否最小化。

此函数的实现是调用Default()，作缺省处理。

CFrameWnd�