MFC 教程

abc · 发表于 2006-12-8 10:08:47

<

align=justify>（3）一个示例
<

align=justify>如果要创建一个编辑框控制，要求它背景使用黄色，其他特性不变，则可以从CEdit派生一个类CYellowEdit，处理通知消息WM_CTLCOLOR的反射消息。CYellowEdit有三个属性，定义如下：
<

align=justify>CYellowEdit::CYellowEdit()
<

align=justify>{
<

align=justify>m_clrText = RGB( 0, 0, 0 );
<

align=justify>m_clrBkgnd = RGB( 255, 255, 0 );
<

align=justify>m_brBkgnd.CreateSolidBrush( m_clrBkgnd );
<

align=justify>}
<

align=justify>使用ClassWizard添加反射消息处理函数：
<

align=justify>函数原型：
afx_msg void HScroll();
消息映射宏：
ON_WM_CTLCOLOR_REFLECT()
函数的框架
HBRUSH CYellowEdit::CtlColor(CDC* pDC, UINT nCtlColor) 
{
// TODO:添加代码改变设备描述表的属性
// TODO: 如果不再调用父窗口的处理，则返回一个非空的刷子句柄
return NULL;
}
添加一些处理到函数CtlColor中，如下：
pDC->SetTextColor( m_clrText );//设置文本颜色
pDC->SetBkColor( m_clrBkgnd );//设置背景颜色
return m_brBkgnd; //返回背景刷
这样，如果某个地方需要使用黄色背景的编辑框，则可以使用CYellowEdit控制。
<OL>
<OL>
<OL>

<LI>对更新命令的接收和处理

用户接口对象如菜单、工具条有多种状态，例如：禁止，可用，选中，未选中，等等。这些状态随着运行条件的变化，由程序来进行更新。虽然程序员可以自己来完成更新，但是MFC框架为自动更新用户接口对象提供了一个方便的接口，使用它对程序员来说可能是一个好的选择。
<OL>

<LI>实现方法

每一个用户接口对象，如菜单、工具条、控制窗口的子窗口，都由唯一的ID号标识，用户和它们交互时，产生相应ID号的命令消息。在MFC里，一个用户接口对象还可以响应CN_UPDATE_COMMAND_UI通知消息。因此，对每个标号ID的接口对象，可以有两个处理函数：一个消息处理函数用来处理该对象产生的命令消息ID，另一个状态更新函数用来处理给该对象的CN_UPDATE_COMMAND_UID的通知消息。
使用ClassWizard可把状态更新函数加入到某个消息处理类，其结果是：
在类的定义中声明一个状态函数；
在消息映射中使用ON_UPDATE_COMMAND_UI宏添加一个映射条目；
在类的实现文件中实现状态更新函数的定义。

ON_UPDATE_COMMAND_UI给指定ID的用户对象指定状态更新函数，例如：
ON_UPDATE_COMMAND_UI(ID_EDIT_COPY, OnUpdateEditCopy)
映射标识号ID为ID_EDIT_COPY菜单的通知消息CN_UPDATE_COMMAND_UI到函数OnUpdateEditCopy。用于给EDIT（编辑菜单）的菜单项ID_EDIT_COPY（复制）添加一个状态处理函数OnUpdateEditCopy，通过处理通知消息CN_UPDATE_COMMAND_UI实现该菜单项的状态更新。
状态处理函数的原型如下：
afxmsg void ClassName::OnUpdateEditPaste(CCmdUI* pCmdUI)
CCmdUI对象由MFC自动地构造。在完善函数的实现时，使用pCmdUI对象和CmdUI的成员函数实现菜单项ID_EDIT_COPY的状态更新，让它变灰或者变亮，也就是禁止或者允许用户使用该菜单项。

<LI>状态更新命令消息

要讨论MFC的状态更新处理，先得了解一条特殊的消息。MFC的消息映射机制除了处理各种Windows消息、控制通知消息、命令消息、反射消息外，还处理一种特别的“通知命令消息”，并通过它来更新菜单、工具栏（包括对话框工具栏）等命令目标的状态。
这种“通知命令消息”是MFC内部定义的，消息ID是WM_COMMAND，通知代码是CN_UPDATE_COMMAND_UI（0XFFFFFFFF）。
它不是一个真正意义上的通知消息，因为没有控制窗口产生这样的通知消息，而是MFC自己主动产生，用于送给工具条窗口或者主边框窗口，通知它们更新用户接口对象的状态。
它和标准WM_COMMAND命令消息也不相同，因为它有特定的通知代码，而命令消息通知代码是0。
但是，从消息的处理角度，可以把它看作是一条通知消息。如果是工具条窗口接收该消息，则在发送机制上它和WM_COMMAND控制通知消息是相同的，相当于让工具条窗口处理一条通知消息。如果是边框窗口接收该消息，则在消息的发送机制上它和WM_COMMAND命令消息是相同的，可以让任意命令目标处理该消息，也就是说边框窗口可以把该条通知消息发送给任意命令目标处理。
从程序员的角度，可以把它看作一条“状态更新命令消息”，像处理命令消息那样处理该消息。每条命令消息都可以对应有一条“状态更新命令消息”。ClassWizard也支持让任意消息目标处理“状态更新命令消息”（包括非窗口命令目标），实现用户接口状态的更新。
在这条消息发送时，通过OnCmdMsg的第三个参数pExtra传递一些信息，表示要更新的用户接口对象。pExtra指向一个CCmdUI对象。这些信息将传递给状态更新命令消息的处理函数。
下面讨论用于更新用户接口对象状态的类CCmdUI。

<LI>类CCmdUI
</LI></OL></LI></OL></OL></OL>
CCmdUI不是从CObject派生，没有基类。
<OL>

<LI>成员变量

m_nID 用户接口对象的ID
m_nIndex 用户接口对象的index
m_pMenu 指向CCmdUI对象表示的菜单
m_pSubMenu 指向CCmdUI对象表示的子菜单
m_pOther 指向其他发送通知消息的窗口对象
m_pParentMenu 指向CCmdUI对象表示的子菜单

<LI>成员函数
</LI></OL>
Enable(BOOL bOn = TRUE ) 禁止用户接口对象或者使之可用
SetCheck( int nCheck = 1) 标记用户接口对象选中或未选中
SetRadio(BOOL bOn = TRUE)
SetText(LPCTSTR lpszText)
ContinueRouting()
还有一个MFC内部使用的成员函数：
DoUpdate(CCmdTarget* pTarget, BOOL bDisableIfNoHndler)
其中，参数1指向处理接收更新通知的命令目标，一般是边框窗口；参数2指示如果没有提供处理函数（例如某个菜单没有对应的命令处理函数），是否禁止用户对象。
DoUpdate作以下事情：
首先，发送状态更新命令消息给参数1表示的命令目标：调用pTarget->OnCmdMsg（m_nID, CN_UPDATE_COMMAND_UI, this, NULL)发送m_nID对象的通知消息CN_UPDATE_COMMAND_UI。OnCmdMsg的参数3取值this，包含了当前要更新的用户接口对象的信息。
然后，如果参数2为TRUE，调用pTarget->OnCmdMsg(m_nID, CN_COMMAND, this, &info)测试命令消息m_nID是否被处理。这时，OnCmdMsg的第四个参数非空，表示仅仅是测试，不是真的要派发消息。如果没有提供命令消息m_nID的处理函数，则禁止用户对象m_nID，否则使之可用。
从上面的讨论可以知道：通过其结构，一个CCmdUI对象标识它表示了哪一个用户接口对象，如果是菜单接口对象，pMenu表示了要更新的菜单对象；如果是工具条，pOther表示了要更新的工具条窗口对象，nID表示了工具条按钮ID。
所以，由参数上状态更新消息的消息处理函数就知道要更新什么接口对象的状态。例如，第1节的函数OnUpdateEditPaste，函数参数pCmdUI表示一个菜单对象，需要更新该菜单对象的状态。
通过其成员函数，一个CCmdUI可以更新、改变用户接口对象的状态。例如，CCmdUI可以管理菜单和对话框控制的状态，调用Enable禁止或者允许菜单或者控制子窗口，等等。
所以，函数OnUpdateEditPaste可以直接调用参数的成员函数（如pCmdUI->Enable）实现菜单对象的状态更新。
由于接口对象的多样性，其他接口对象将从CCmdUI派生出管理自己的类来，覆盖基类的有关成员函数如Enable等，提供对自身状态更新的功能。例如管理状态条和工具栏更新的CStatusCmdUI类和CToolCmdUI类。
<OL>
<OL>
<OL>
<OL>

<LI>自动更新用户接口对象状态的机制
</LI></OL></OL></OL></OL>
MFC提供了分别用于更新菜单和工具条的两种途径。
<OL>

<LI>更新菜单状态

当用户对菜单如File单击鼠标时，就产生一条WM_INITMENUPOPUP消息，边框窗口在菜单下拉之前响应该消息，从而更新该菜单所有项的状态。
在应用程序开始运行时，边框也会收到WM_INITMENUPOPUP消息。

<LI>更新工具条等状态

当应用程序进入空闲处理状态时，将发送WM_IDLEUPDATECMDUI消息，导致所有的工具条用户对象的状态处理函数被调用，从而改变其状态。WM_IDLEUPDATECMDUI是MFC自己定义和使用的消息。
在窗口初始化时，工具条也会收到WM_IDLEUPDATECMDUI消息。

<LI>菜单状态更新的实现

MFC让边框窗口来响应WM_INITMENUPOPUP消息，消息处理函数是OnInitMenuPopup，其原型如下：
afx_msg void CFrameWnd::OnInitMenuPopup( CMenu* pPopupMenu,
UINT nIndex, BOOL bSysMenu );
第一个参数指向一个CMenu对象，是当前按击的菜单；第二个参数是菜单索引；第三个参数表示子菜单是否是系统控制菜单。
函数的处理：
如果是系统控制菜单，不作处理；否则，创建CCmdUI对象state，给它的各个成员如m_pMenu，m_pParentMenu，m_pOther等赋值。
对该菜单的各个菜单项，调函数state.DoUpdate，用CCmdUI的DoUpdate来更新状态。DoUpdate的第一个参数是this，表示命令目标是边框窗口；在CFrameWnd的成员变量m_bAutoMenuEnable为TRUE时（表示如果菜单m_nID没有对应的消息处理函数或状态更新函数，则禁止它），把DoUpdate的第二个参数bDisableIfNoHndler置为TRUE。
顺便指出，m_bAutoMenuEnable缺省时为TRUE，所以，应用程序启动时菜单经过初始化处理，没有提供消息处理函数或状态更新函数的菜单项被禁止。

<LI>工具条等状态更新的实现
</LI></OL>
图4-5表示了消息空闲时MFC更新用户对象状态的流程：
MFC提供的缺省空闲处理向顶层窗口(框架窗口)的所有子窗口发送消息WM_IDLEUPDATECMDUI；MFC的控制窗口（工具条、状态栏等）实现了对该消息的处理，导致用户对象状态处理函数的调用。

虽然两种途径调用了同一状态处理函数，但是传递的 CCmdUI参数从内部构成上是不一样的：第一种传递的CCmdUI对象表示了一菜单对象，(pMenu域被赋值)；第二种传递了一个窗口对象(pOther域被赋值)。同样的状态改变动作，如禁止、允许状态的改变，前者调用了CMenu的成员函数EnableMenuItem，后者使用了CWnd的成员函数EnabelWindow。但是，这些不同由CCmdUI对象内部区分、处理，对用户是透明的：不论菜单还是对应的工具条，用户都用同一个状态处理函数使用同样的形式来处理。<IMG src="http://www.vczx.com/tutorial/mfc/image117.gif" align=left>

　
这一节分析了用户界面更新的原理和机制。在后面第13章讨论工具条和状态栏时，将详细的分析这种机制的具体实现。
<OL>
<OL>

<LI>消息的预处理

到现在为止，详细的讨论了MFC的消息映射机制。但是，为了提高效率和简化处理，MFC提供了一种消息预处理机制，如果一条消息在预处理时被过滤掉了（被处理），则不会被派发给目的窗口的窗口过程，更不会进入消息循环了。
显然，能够进行预处理的消息只可能是队列消息，而且必须在消息派发之前进行预处理。因此，MFC在实现消息循环时，对于得到的每一条消息，首先送给目的窗口、其父窗口、其祖父窗口乃至最顶层父窗口，依次进行预处理，如果没有被处理，则进行消息转换和消息派发，如果某个窗口实现了预处理，则终止。有关实现见后面关于CWinThread线程类的章节，CWinThread的Run函数和PreTranslateMessage函数以及CWnd的函数WalkPreTranslateTree实现了上述要求和功能。这里要讨论的是MFC窗口类如何进行消息预处理。
CWnd提供了虚拟函数PreTranslateMessage来进行消息预处理。CWnd的派生类可以覆盖该函数，实现自己的预处理。下面，讨论几个典型的预处理。
首先，是CWnd的预处理：
预处理函数的原型为：
BOOL CWnd:

reTranslateMessage(MSG* pMsg)
CWnd类主要是处理和过滤Tooltips消息。关于该函数的实现和Tooltips消息，见后面第13章关于工具栏的讨论。

然后，是CFrameWnd的预处理：
CFrameWnd除了调用基类CWnd的实现过滤Tooltips消息之外，还要判断当前消息是否是键盘快捷键被按下，如果是，则调用函数::TranslateAccelerator(m_hWnd, hAccel, pMsg)处理快捷键。

接着，是CMDIChildWnd的预处理：
CMDIChildWnd的预处理过程和CFrameWnd的一样，但是不能依靠基类CFrameWnd的实现，必须覆盖它。因为MDI子窗口没有菜单，所以它必须在MDI边框窗口的上下文中来处理快捷键，它调用了函数::TranslateAccelerator(GetMDIFrame()->m_hWnd, hAccel, pMsg)。

讨论了MDI子窗口的预处理后，还要讨论MDI边框窗口：
CMDIFrameWnd的实现除了CFrameWnd的实现的功能外，它还要处理MDI快捷键（标准MDI界面统一使用的系统快捷键）。

在后面，还会讨论CDialog、CFormView、CToolBar等的消息预处理及其实现。
至于CWnd::WalkPreTranslateTree函数，它从接受消息的窗口开始，逐级向父窗回溯，逐一对各层窗口调用PreTranslateMessage函数，直到消息被处理或者到最顶层窗口为止。
</LI></OL></OL>

abc · 发表于 2006-12-8 10:09:19

<OL>
<LI>
<

>MFC消息映射的回顾 
</LI></OL>
<

align=justify>从处理命令消息的过程可以看出，Windows消息和控制消息的处理要比命令消息的处理简单，因为查找消息处理函数时，后者只要搜索当前窗口对象(this所指)的类或其基类的消息映射入口表。但是，命令消息就要复杂多了，它沿一定的顺序链查找链上的各个命令目标，每一个被查找的命令目标都要搜索它的类或基类的消息映射入口表。
<

align=justify>MFC通过消息映射的手段，以一种类似C++虚拟函数的概念向程序员提供了一种处理消息的方式。但是，若使用C++虚拟函数实现众多的消息，将导致虚拟函数表极其庞大；而使用消息映射，则仅仅感兴趣的消息才加入映射表，这样就要节省资源、提高效率。这套消息映射机制的基础包括以下几个方面：
<OL>
<

align=justify>
<LI>消息映射入口表的实现：采用了C++静态成员和虚拟函数的方法来表示和得到一个消息映射类(CCmdTarget或派生类)的映射表。

<

align=justify>
<LI>消息查找的实现：从低层到高层搜索消息映射入口表，直至根类CCmdTarget。

<

align=justify>
<LI>消息发送的实现：主要以几个虚拟函数为基础来实现标准MFC消息发送路径：OnComamnd、OnNotify、OnWndMsg和OnCmdMsg。、
</LI></OL>
<

align=justify>
<

align=justify>OnWndMsg是CWnd类或其派生类的成员函数，由窗口过程调用。它处理标准的Windows消息。
<

align=justify>OnCommand是CWnd类或其派生类的成员函数，由OnWndMsg调用来处理WM_COMMAND消息，实现命令消息或者控制通知消息的发送。如果派生类覆盖该函数，则必须调用基类的实现，否则将不能自动的处理命令消息映射，而且必须使用该函数接受的参数（不是程序员给定值）调用基类的OnCommand。
<

align=justify>OnNotify是CWnd类或其派生类的成员函数，由OnWndMsg调用来处理WM_NOTIFY消息，实现控制通知消息的发送。
OnCmdMsg是CCmdTarget类或其派生类的成员函数。被OnCommand调用，用来实现命令消息发送和派发命令消息到命令消息处理函数。

自动更新用户对象状态是通过MFC的命令消息发送机制实现的。
控制消息可以反射给控制窗口处理。
队列消息在发送给窗口过程之前可以进行消息预处理，如果消息被MFC窗口对象预处理了，则不会进入消息发送过程。
MFC对象的创建 

前面几章介绍了MFC的核心概念和思想，即介绍了MFC对Windows对象的封装方法和特点；MFC对象的动态创建、序列化；MFC消息映射机制。
现在，考查MFC的应用程序结构体系，即以文档-视为核心的编程模式。学习本章，应该弄清楚以下问题：
MFC中诸多MFC对象的关系：应用程序对象，文档对象，边框窗口对象，文档边框窗口对象，视对象，文档模板对象等。
MFC对象的创建和销毁：由什么对象创建或销毁什么对象，何时创建，何时销毁？
MFC提供了那些接口来支持其编程模式？
<OL>

<LI>MFC对象的关系

<OL>

<LI>创建关系
<IMG src="http://www.vczx.com/tutorial/mfc/image118.gif" align=left> 
这里讨论应用程序、文档模板、边框窗口、视、文档等的创建关系。图5-1大略地表示了创建顺序，但表5-1更直接地显示了创建与被创建的关系。
　
表5-1 MFC对象的创建关系
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="47%">
创建者 </TD>
<TD vAlign=top width="53%">
被创建的对象 </TD></TR>
<TR>
<TD vAlign=top width="47%">
应用程序对象 </TD>
<TD vAlign=top width="53%">
文档模板 </TD></TR>
<TR>
<TD vAlign=top width="47%">
文档模板 </TD>
<TD vAlign=top width="53%">
文档 </TD></TR>
<TR>
<TD vAlign=top width="47%">
文档模板 </TD>
<TD vAlign=top width="53%">
边框窗口 </TD></TR>
<TR>
<TD vAlign=top width="47%">
边框窗口 </TD>
<TD vAlign=top width="53%">
视 </TD></TR></TABLE></LI></OL></LI></OL>

abc · 发表于 2006-12-8 10:09:50

<OL>
<LI>
<

>交互作用关系 
</LI>
<LI>
<DIV align=justify>应用程序对象有一个文档模板列表，存放一个或多个文档模板对象；文档模板对象有一个打开文档列表，存放一个或多个已经打开的文档对象；文档对象有一个视列表，存放显示该文档数据的一个或多个视对象；还有一个指针指向创建该文档的文档模板对象；视有一个指向其关联文档的指针，视是一个子窗口，其父窗口是边框窗口（或者文档边框窗口）；文档边框窗口有一个指向其当前活动视的指针；文档边框窗口是边框窗口的子窗口。</DIV></LI>
<LI>
<DIV align=justify>Windows 管理所有已经打开的窗口，把消息或事件发送给目标窗口。通常，命令消息发送给主边框窗口。</DIV></LI>
<LI><IMG src="http://www.vczx.com/tutorial/mfc/image119.gif" align=left> </LI>
<LI>
<DIV align=justify>图5-2大略地表示了上述关系：</DIV></LI>
<LI>
<DIV align=justify> </DIV></LI>
<LI>
<DIV align=justify>MFC提供了一些函数来维护这些关系。</DIV></LI>
<LI>
<DIV align=justify>表5-2列出了从一个对象得到相关对象的方法。</DIV></LI>
<LI>
<DIV align=center>表5-2 从一个对象得到另一个对象的方法</DIV></LI></OL>
<DIV>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="29%">
<OL>
<LI>
<DIV align=center>本对象 </DIV></LI></OL></TD>
<TD vAlign=top width="27%">
<

align=center>要得到的对象 </TD>
<TD vAlign=top width="44%">
<

align=justify>使用的成员函数 </TD></TR>
<TR>
<TD vAlign=top width="29%" rowSpan=2>
<

align=justify>CDocument对象 </TD>
<TD vAlign=top width="27%">
<

align=justify>视列表 </TD>
<TD vAlign=top width="44%">
<

align=justify>GetFirstViewPosition
<

align=justify>GetNextView </TD></TR>
<TR>
<TD vAlign=top width="27%">
<

align=justify>文档模板 </TD>
<TD vAlign=top width="44%">
<

align=justify>GetDocTemplate </TD></TR>
<TR>
<TD vAlign=top width="29%" rowSpan=2>
<

align=justify>CView对象 </TD>
<TD vAlign=top width="27%">
文档对象 </TD>
<TD vAlign=top width="44%">
GetDocument </TD></TR>
<TR>
<TD vAlign=top width="27%">
边框窗口 </TD>
<TD vAlign=top width="44%">
GetParentFrame </TD></TR>
<TR>
<TD vAlign=top width="29%" rowSpan=2>
CMDIChildWnd或
CFrameWnd对象 </TD>
<TD vAlign=top width="27%">
活动视 </TD>
<TD vAlign=top width="44%">
GetActiveView </TD></TR>
<TR>
<TD vAlign=top width="27%">
活动视的文档 </TD>
<TD vAlign=top width="44%">
GetActiveDocument </TD></TR>
<TR>
<TD vAlign=top width="29%">
CMDIFrameWnd对象 </TD>
<TD vAlign=top width="27%">
活动文档边框窗口 </TD>
<TD vAlign=top width="44%">
MDIGetActive </TD></TR></TABLE></DIV>
<OL>
<LI>
<DIV align=center>　</DIV></LI>
<LI>
<DIV align=center>表5-3 从一个对象通知另一个对象的方法：</DIV></LI></OL>
<DIV>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="31%">
<OL>
<LI>
<DIV align=justify>本对象 </DIV></LI></OL></TD>
<TD vAlign=top width="30%">
要通知的对象/动作 </TD>
<TD vAlign=top width="39%">
使用的成员函数 </TD></TR>
<TR>
<TD vAlign=top width="31%">
CView对象 </TD>
<TD vAlign=top width="30%">
通知文档更新所有视 </TD>
<TD vAlign=top width="39%">
CDocument::UpdateAllViews </TD></TR>
<TR>
<TD vAlign=top width="31%">
CDocument对象 </TD>
<TD vAlign=top width="30%">
更新一个视 </TD>
<TD vAlign=top width="39%">
CView::OnUpdate </TD></TR>
<TR>
<TD vAlign=top width="31%" rowSpan=2>
CFrameWnd或
CMDIFrameWnd对象 </TD>
<TD vAlign=top width="30%">
通知一个视为活动视 </TD>
<TD vAlign=top width="39%">
CView::OnActivateView </TD></TR>
<TR>
<TD vAlign=top width="30%">
设置一个视为活动视 </TD>
<TD vAlign=top width="39%">
SetActivateView </TD></TR></TABLE></DIV>

<OL>
<LI>
<DIV align=justify>可以通过表5-2得到相关对象，再调用表5-3中相应的函数。例如：视在接受了新数据或者数据被修改之后，使用表5-2中的函数GetDocument得到关联文档对象，然后调用表5-3中的文档函数UpdateAllViews更新其他和文档对象关联的视。</DIV></LI>
<LI>
<DIV align=justify>在表5-2和表5-3中，CView对象指CView或派生类的实例；成员函数列中如果没有指定类属，就是第一列对象的类的成员函数。</DIV></LI>
<LI>
<DIV align=justify> </DIV></LI>
<LI>MFC提供的接口 </LI>
<LI></LI>
<LI>
<DIV align=justify>MFC编程就是把一些应用程序特有的东西填入MFC框架。MFC提供了两种填入的方法：一种就是使用前一章论述的消息映射，消息映射给应用程序的各种对象处理各种消息的机会；另一种就是使用虚拟函数，MFC在实现许多功能或者处理消息、事件的过程中，调用了虚拟函数来完成一些任务，这样就给了派生类覆盖这些虚拟函数实现特定处理的机会。</DIV></LI>
<LI>
<DIV align=justify>下面两节将列出两类接口，有两个目的：一是为了让读者获得整体印象，二是后文将涉及到或者讨论其中的许多函数时，不显得突兀。</DIV></LI>
<LI>
<DIV align=justify> </DIV></LI>
<LI>虚拟函数接口

几乎每一个MFC类都定义和使用了虚拟成员函数，程序员可以在派生类中覆盖它们。一般，MFC提供了这些函数的缺省实现，所以覆盖函数应该调用基类的实现。这里给出一个MFC常用虚拟函数的总览表(见表5-4)，更详细的信息或它们的缺省实现动作参见MFC文档。由于基类的虚拟函数被派生类继承，所以在派生类中不作重复说明。
覆盖基类的虚拟函数可以通过ClassWizard进行，不过，并非所有的函数都可以这样，有的必须手工加入函数声明和实现。
表5-4 常见MFC类的虚拟函数接口
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

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

　
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

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

abc · 发表于 2006-12-8 10:11:59

<

align=justify>　
<TABLE cellSpacing=1 cellPadding=7 width=451 border=1>

<TR>
<TD vAlign=top colSpan=3>
<

align=justify>续表 </TD></TR>
<TR>
<TD vAlign=top width="26%">　</TD>
<TD vAlign=top width="32%">
<

align=justify>GetWindowMenuPopup </TD>
<TD vAlign=top width="43%">
<

align=justify>返回窗口的弹出式菜单 </TD></TR>
<TR>
<TD vAlign=top width="26%" rowSpan=4>
<

align=justify>CDialog </TD>
<TD vAlign=top width="32%">
<

align=justify>OnInitDialog </TD>
<TD vAlign=top width="43%">
<

align=justify>对话框窗口的初始化 </TD></TR>
<TR>
<TD vAlign=top width="32%">
<

align=justify>OnSetFont </TD>
<TD vAlign=top width="43%">
<

align=justify>设置对话框控制的文本字体 </TD></TR>
<TR>
<TD vAlign=top width="32%">
<

align=justify>OnOK </TD>
<TD vAlign=top width="43%">
模式对话框的OK按钮按下后进行的处理 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnCancel </TD>
<TD vAlign=top width="43%">
模式对话框的CANCEL按钮按下后进行的处理 </TD></TR>
<TR>
<TD vAlign=top width="26%" rowSpan=11>
CView </TD>
<TD vAlign=top width="32%">
IsSelected </TD>
<TD vAlign=top width="43%">
测试是否有一个文档被选择(OLE支持) </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnActivateView </TD>
<TD vAlign=top width="43%">
视窗口激活时调用 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnActivateFrame </TD>
<TD vAlign=top width="43%">
当包含视窗口的框架窗口变成活动或非活动窗口时调用 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnBeginPrinting </TD>
<TD vAlign=top width="43%">
打印工作开始时调用，用来分配GDI资源 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnDraw </TD>
<TD vAlign=top width="43%">
用来屏幕显示、打印、打印预览文档内容 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnEndPrinting </TD>
<TD vAlign=top width="43%">
打印工作结束时调用，释放GDI资源 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnEndPrintPreview </TD>
<TD vAlign=top width="43%">
退出打印预览模式时调用 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnPrepareDC </TD>
<TD vAlign=top width="43%">
OnDraw或OnPrint之前调用，用来准备设备描述表 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnPreparePrinting </TD>
<TD vAlign=top width="43%">
文档打印或者打印预览前调用，可用来初始化打印对话框 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnPrint </TD>
<TD vAlign=top width="43%">
用来打印或打印预览文档 </TD></TR>
<TR>
<TD vAlign=top width="32%">
OnUpdate </TD>
<TD vAlign=top width="43%">
用来通知一个视的关联文档内容已经变化 </TD></TR>
<TR>
<TD vAlign=top width="26%">
CDocTemplate </TD>
<TD vAlign=top width="32%">
MatchDocType </TD>
<TD vAlign=top width="43%">
确定文档类型和文档模板匹配时的可信程度 </TD></TR>
<TR>
<TD vAlign=top colSpan=3>
转下页 </TD></TR></TABLE>

　
<TABLE cellSpacing=1 cellPadding=7 width=451 border=1>

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

abc · 发表于 2006-12-8 10:12:15

<OL>
<LI>
<

>消息映射方法和标准命令消息 
</LI>
<LI>
<DIV align=justify>窗口对象可以响应以“WM_”为前缀的标准Windows消息，消息处理函数名称以“ON”为前缀。不同类型的Windows窗口处理的Windows消息是有所不同的，因此，不同类型的MFC窗口实现的消息处理函数也有所不同。例如，多文档边框窗口能处理WM_MDIACTIVATE消息，其他类型窗口就不能。程序员从一定的MFC窗口派生自己的窗口类，对感兴趣的消息，覆盖基类的消息处理函数，实现自己的消息处理函数。</DIV></LI>
<LI>
<DIV align=justify>所有的命令目标（CCmdTarger或导出类对象）可以响应命令消息，程序员可以指定应用程序对象、框架窗口对象、视对象或文档对象等来处理某条命令消息。一般地，尽量由与命令消息关系密切的对象来处理，例如隐藏/显示工具栏由框架窗口处理，打开文件由应用程序对象处理，数据变化的操作由文档对象处理。</DIV></LI>
<LI>
<DIV align=justify>对话框的控制子窗口可以响应各类通知消息。</DIV></LI>
<LI>
<DIV align=justify> </DIV></LI>
<LI>
<DIV align=justify>对于命令消息，MFC实现了一系列标准命令消息处理函数。标准命令ID在afxres.h中定义。表5-5列出了MFC标准命令的实现，从ID或者函数名可以大致地看出该函数的目的、功用，具体的实现有的后续章节会讲解，详细参见MFC技术文档。</DIV></LI>
<LI>
<DIV align=justify>程序员可以自己来处理这些标准消息，也可以通过不同的类或从不同的类导出自己的类来处理这些消息，不过最好遵循MFC的缺省实现。比如处理ID_FILE_NEW命令，最好由CWinApp的派生类处理。</DIV></LI>
<LI>
<DIV align=justify>　</DIV></LI>
<LI>
<DIV align=center>表5-5 标准命令消息处理函数</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=504 border=1>

<TR>
<TD vAlign=top width="37%" height=21>
<OL>
<LI>
<DIV align=justify>ID </DIV></LI></OL></TD>
<TD vAlign=top width="32%" height=21>
<

align=justify>函数 </TD>
<TD vAlign=top width="31%" height=21>
<

align=justify>实现函数的类 </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
<

align=justify>ID_FILE_NEW </TD>
<TD vAlign=top width="32%" height=20>
<

align=justify>OnFileNew </TD>
<TD vAlign=top width="31%" height=20>
<

align=justify>CWinApp </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
<

align=justify>ID_FILE_OPEN </TD>
<TD vAlign=top width="32%" height=20>
<

align=justify>OnFileOpen </TD>
<TD vAlign=top width="31%" height=20>
<

align=justify>CWinApp </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
<

align=justify>ID_FILE_CLOSE </TD>
<TD vAlign=top width="32%" height=20>
OnFileClose </TD>
<TD vAlign=top width="31%" height=20>
CDocument </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
ID_FILE_SAVE </TD>
<TD vAlign=top width="32%" height=20>
OnFileSave </TD>
<TD vAlign=top width="31%" height=20>
CDocument </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
ID_FILE_SAVE_AS </TD>
<TD vAlign=top width="32%" height=20>
OnFileSaveAs </TD>
<TD vAlign=top width="31%" height=20>
CDocument </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
ID_FILE_SAVE_COPY_AS </TD>
<TD vAlign=top width="32%" height=20>
OnFileSaveCopyAs </TD>
<TD vAlign=top width="31%" height=20>
COleServerDoc </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
ID_FILE_UPDATE </TD>
<TD vAlign=top width="32%" height=20>
OnUpdateDocument </TD>
<TD vAlign=top width="31%" height=20>
COleServerDoc </TD></TR>
<TR>
<TD vAlign=top width="37%" height=20>
ID_FILE_PAGE_SETUP </TD>
<TD vAlign=top width="32%" height=20>
OnFilePrintSetup </TD>
<TD vAlign=top width="31%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top colSpan=3 height=20>
转下页 </TD></TR></TABLE>

<OL>
<LI>
<DIV align=justify>　</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top colSpan=3 height=20>
<OL>
<LI>
<DIV align=justify>续表 </DIV></LI></OL></TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_FILE_PRINT </TD>
<TD vAlign=top width="33%" height=20>
OnFilePrint </TD>
<TD vAlign=top width="30%" height=20>
CView </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_FILE_PRINT_PREVIEW </TD>
<TD vAlign=top width="33%" height=20>
OnFilePrintPreview </TD>
<TD vAlign=top width="30%" height=20>
CView </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_FILE_MRU_FILE1...FILE16 </TD>
<TD vAlign=top width="33%" height=20>
OnUpdateRecentFileMenu </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_CLEAR </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
CView没有实现， </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_CLEAR_ALL </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
但是，如果有实现 </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_COPY </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
函数，就是派生类 </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_CUT </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
CEditView的 </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_FIND </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
实现函数 </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_PASTE_LINK </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_PASTE_SPECIAL </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_REPEAT </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_REPLACE </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_SELET_ALL </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_EDIT_UNDO </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_WINDOW_NEW </TD>
<TD vAlign=top width="33%" height=20>
OnWindowNew </TD>
<TD vAlign=top width="30%" height=20>
CMDIFrameWnd </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_WINDOW_ARRANGE </TD>
<TD vAlign=top width="33%" height=20>
OnMDIWindowCmd </TD>
<TD vAlign=top width="30%" height=20>
CMDIFrameWnd </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_WINDOW_CASCADE </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_WINDOW_TILE_HORZ </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_WINDOW_TILE_VERT </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_WINDOW_SPLIT </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
CSplitterWnd </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_APP_ABOUT </TD>
<TD vAlign=top width="33%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_APP_EXIT </TD>
<TD vAlign=top width="33%" height=20>
OnAppExit </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_HELP_INDEX </TD>
<TD vAlign=top width="33%" height=20>
OnHelpIndex </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_HELP_USING </TD>
<TD vAlign=top width="33%" height=20>
OnHelpUsing </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top width="38%" height=20>
ID_CONTEXT_HELP </TD>
<TD vAlign=top width="33%" height=20>
OnContextHelp </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top colSpan=3 height=20>
转下页 </TD></TR></TABLE>

<OL>
<LI>
<DIV align=justify>　</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top colSpan=3 height=20>
<OL>
<LI>
<DIV align=justify>续表 </DIV></LI></OL></TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_HELP </TD>
<TD vAlign=top width="31%" height=20>
OnHelp </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_DEFAULT_HELP </TD>
<TD vAlign=top width="31%" height=20>
OnHelpIndex </TD>
<TD vAlign=top width="30%" height=20>
CWinApp </TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_NEXT_PANE </TD>
<TD vAlign=top width="31%" height=20>
OnNextPaneCmd </TD>
<TD vAlign=top width="30%" height=20>
CSplitterWnd </TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_PREV_PANE </TD>
<TD vAlign=top width="31%" height=20>
OnNextPaneCmd </TD>
<TD vAlign=top width="30%" height=20>
CSplitterWnd </TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_OLE_INSERT_NEW </TD>
<TD vAlign=top width="31%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_OLE_EDIT_LINKS </TD>
<TD vAlign=top width="31%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_OLE_VERB_FIRST...LAST </TD>
<TD vAlign=top width="31%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
</TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_VIEW_TOOLBAR </TD>
<TD vAlign=top width="31%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
CFrameWnd </TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_VIEW_STATUS_BAR </TD>
<TD vAlign=top width="31%" height=20>
</TD>
<TD vAlign=top width="30%" height=20>
CFrameWnd </TD></TR>
<TR>
<TD vAlign=top width="39%" height=20>
ID_INDICATOR_CAPS
ID_INDICATOR_NUM
ID_INDICATOR_SCRL
ID_INDICATOR_KANA </TD>
<TD vAlign=top width="31%" height=20>
OnUpdateKeyIndica</TD></TR></TABLE>

abc · 发表于 2006-12-8 10:13:28

MFC对象的创建过程
<

>
<

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

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

align=justify>
<LI>应用程序中典型对象的结构
<

>
<

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

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

align=justify>
<LI>应用程序类的成员变量
<

>
<

align=justify>应用程序对象的数据成员表由两部分组成，第一部分是CWinThread的成员变量，如表5-6所示，CWinApp继承了CWinThread的数据成员。第二部分是CWinApp自己定义的成员变量，如表5-7所示。
表5-6 CwinThread的成员变量
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

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

<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

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

abc · 发表于 2006-12-8 10:14:05

<LI>
<OL>
<LI>CDocument的成员变量 </LI>
<LI></LI>
<LI>
<DIV align=center>表5-8 文档对象的属性。</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="4%">
<OL>
<LI>　</LI></OL></TD>
<TD vAlign=top width="14%">
<

align=justify>访问限制 </TD>
<TD vAlign=top width="24%">
<

align=justify>变量名称 </TD>
<TD vAlign=top width="23%">
<

align=justify>类型 </TD>
<TD vAlign=top width="35%">
<

align=justify>解释 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
<

align=justify>protected </TD>
<TD vAlign=top width="24%">
<

align=justify>m_strTitle </TD>
<TD vAlign=top width="23%">
<

align=justify>CString </TD>
<TD vAlign=top width="35%">
<

align=justify>文档标题 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
<

align=justify>protected </TD>
<TD vAlign=top width="24%">
<

align=justify>m_strPathName </TD>
<TD vAlign=top width="23%">
CString </TD>
<TD vAlign=top width="35%">
文档路径 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="24%">
m_pDocTemplate </TD>
<TD vAlign=top width="23%">
CDocTemplate* </TD>
<TD vAlign=top width="35%">
指向文档模板的指针 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="24%">
m_viewList </TD>
<TD vAlign=top width="23%">
CPtrList </TD>
<TD vAlign=top width="35%">
关联的视窗口列表 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="24%">
m_bModified </TD>
<TD vAlign=top width="23%">
BOOL </TD>
<TD vAlign=top width="35%">
文档是否有变化、需要存盘 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="24%">
m_bAutoDelete </TD>
<TD vAlign=top width="23%">
BOOL </TD>
<TD vAlign=top width="35%">
关联视都关闭时是否删除文档对象 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="24%">
m_bEmbedded </TD>
<TD vAlign=top width="23%">
BOOL </TD>
<TD vAlign=top width="35%">
文档是否由OLE创建 </TD></TR></TABLE></LI>
<OL>
<LI>
文档模板的属性 
</LI>
<LI>
<DIV align=justify>表5-9列出了文档模板的成员变量，5-10列出了单文档模板的成员变量，5-11列出了多文档模板的成员变量。单、多文档模板继承了文档模板的成员变量。</DIV></LI>
<LI>
<DIV align=center>表5-9 文档模板的数据成员</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="4%">
<OL>
<LI>　</LI></OL></TD>
<TD vAlign=top width="14%">
访问限制 </TD>
<TD vAlign=top width="28%">
变量名称 </TD>
<TD vAlign=top width="15%">
类型 </TD>
<TD vAlign=top width="38%">
解释 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_bAutoDelete </TD>
<TD vAlign=top width="15%">
BOOL </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_pAttachedFactory </TD>
<TD vAlign=top width="15%">
CObject * </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_hMenuInPlace </TD>
<TD vAlign=top width="15%">
HMENU </TD>
<TD vAlign=top width="38%">
就地激活时，OLE客户程序的菜单 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_hAccelInPlace </TD>
<TD vAlign=top width="15%">
HACCEL </TD>
<TD vAlign=top width="38%">
就地激活时，OLE客户程序的快捷键 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_hMenuEmbedding </TD>
<TD vAlign=top width="15%">
HMENU </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_hAccelEmbedding </TD>
<TD vAlign=top width="15%">
HACCEL </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_hMenuInPlaceServer </TD>
<TD vAlign=top width="15%">
HMENU </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_hAccelInPlaceServer </TD>
<TD vAlign=top width="15%">
HACCEL </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="28%">
m_nIDResource </TD>
<TD vAlign=top width="15%">
UINT </TD>
<TD vAlign=top width="38%">
框架、菜单、快捷键等的资源ID </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="28%">
m_nIDServerResource </TD>
<TD vAlign=top width="15%">
UINT </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_nIDEmbeddingResource </TD>
<TD vAlign=top width="15%">
UINT </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_nIDContainerResource </TD>
<TD vAlign=top width="15%">
UINT </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_pDocClass </TD>
<TD vAlign=top width="15%">
CRuntimeClass* </TD>
<TD vAlign=top width="38%">
指向文档类的动态创建信息 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_pFrameClass </TD>
<TD vAlign=top width="15%">
CRuntimeClass* </TD>
<TD vAlign=top width="38%">
指向框架类的动态创建信息 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_pViewClass </TD>
<TD vAlign=top width="15%">
CRuntimeClass* </TD>
<TD vAlign=top width="38%">
指向视类的动态创建信息，由字符串m_nIDResource描述 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_pOleFrameClass </TD>
<TD vAlign=top width="15%">
CRuntimeClass* </TD>
<TD vAlign=top width="38%">
指向OLD框架类的动态创建信息 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_pOleViewClass </TD>
<TD vAlign=top width="15%">
CRuntimeClass* </TD>
<TD vAlign=top width="38%">　</TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
public </TD>
<TD vAlign=top width="28%">
m_strDocStrings </TD>
<TD vAlign=top width="15%">
CString </TD>
<TD vAlign=top width="38%">
描述该文档类型的字符串 </TD></TR></TABLE>
<OL>
<LI>
<DIV align=center>表5-10 单文档模板的成员变量</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="4%">
<OL>
<LI>　</LI></OL></TD>
<TD vAlign=top width="14%">
访问限制 </TD>
<TD vAlign=top width="19%">
变量名称 </TD>
<TD vAlign=top width="17%">
类型 </TD>
<TD vAlign=top width="45%">
解释 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="19%">
m_pOnlyDoc </TD>
<TD vAlign=top width="17%">
CDocment* </TD>
<TD vAlign=top width="45%">
指向唯一的文档对象 </TD></TR></TABLE>

abc · 发表于 2006-12-8 10:14:27

<OL>
<LI>
<DIV align=center>表5-11 单文档模板的成员变量</DIV></LI></OL>
<TABLE cellSpacing=1 cellPadding=7 width=497 border=1>

<TR>
<TD vAlign=top width="4%">
<OL>
<LI>　</LI></OL></TD>
<TD vAlign=top width="14%">
<

align=justify>访问限制 </TD>
<TD vAlign=top width="28%">
<

align=justify>变量名称 </TD>
<TD vAlign=top width="15%">
<

align=justify>类型 </TD>
<TD vAlign=top width="38%">
<

align=justify>解释 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
<

align=justify>public </TD>
<TD vAlign=top width="28%">
<

align=justify>m_hMenuShared </TD>
<TD vAlign=top width="15%">
<

align=justify>HMENU </TD>
<TD vAlign=top width="38%">
<

align=justify>该模板的MDI子窗口的菜单 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
<

align=justify>public </TD>
<TD vAlign=top width="28%">
<

align=justify>m_hAccelTable </TD>
<TD vAlign=top width="15%">
HACCEL </TD>
<TD vAlign=top width="38%">
该模板的MDI子窗口的快捷键 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="28%">
m_docList </TD>
<TD vAlign=top width="15%">
CPtrList </TD>
<TD vAlign=top width="38%">
该模板的文档列表 </TD></TR>
<TR>
<TD vAlign=top width="4%">　</TD>
<TD vAlign=top width="14%">
protected </TD>
<TD vAlign=top width="28%">
m_nUntitledCount </TD>
<TD vAlign=top width="15%">
UINT </TD>
<TD vAlign=top width="38%">
用来生成文件名的数字，如”untitled0”的0。 </TD></TR></TABLE>

<OL>
<LI>WinMain入口函数 </LI>
<LI></LI>
<LI>
<DIV align=justify> </DIV></LI>
<LI>WinMain流程

现在讨论MFC应用程序如何启动。
WinMain函数是MFC提供的应用程序入口。进入WinMain前，全局应用程序对象已经生成。WinMain流程如图5-3所示。图中，灰色框是对被调用的虚拟函数的注释，程序员可以或必须覆盖它以实现MFC要求的或用户希望的功能；大括号所包含的图示是相应函数流程的细化，有应用程序对象App的初始化、Run函数的实现、PumpMessage的流程，等等。
<IMG src="http://www.vczx.com/tutorial/mfc/image120.gif">
从图中可以看出：
（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:

umpMessage
该函数在MFC函数文档里没有描述，但是MFC建议用户使用。它实现获取消息，转换(Translate)消息，发送消息的消息循环。在转换消息之前，调用虚拟函数PreTranslateMessage对消息进行预处理，该函数得到消息目的窗口对象之后，使用CWnd的WalkPreTranslateTree让目的窗口及其所有父窗口得到一个预处理当前消息的机会。关于消息预处理，见消息映射的有关章节。如果是WM_QUIT消息，PumpMessage返回FALSE；否则返回TRUE。
</LI></OL>

abc · 发表于 2006-12-8 10:14:49

<OL>
<LI>
<

>MFC空闲处理 
</LI></OL>
<

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

align=justify>
<LI>空闲处理由函数OnIdle完成，其原型为BOOL OnIdle（int）。参数的含义是当前空闲处理周期已经完成了多少次OnIdle调用，每个空闲处理周期的第一次调用，该参数设为0，每调用一次加1；返回值表示当前空闲处理周期是否继续调用OnIdle。

<

align=justify>
<LI>MFC的缺省实现里，CWinThread::OnIdle完成了工具栏等的状态更新。如果覆盖OnIdle，需要调用基类的实现。

<

align=justify>
<LI>在处理完一个消息或进入消息循环时，如果消息队列中没有消息要处理，则MFC开始一个新的空闲处理周期；

<

align=justify>
<LI>当OnIdle返回FASLE，或者消息队列中有消息要处理时，当前的空闲处理周期结束。
</LI></OL>
<DIR>
<

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

align=justify></DIR>
<

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

align=justify>
<LI>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;

对于第二部分，又可以分解成许多步骤。
下面将解释每一步。
<OL>

<LI>文档模板的创建

第一步是创建文档模板。
文档模板的作用是动态创建其他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，把创建的模板对象加入到文档模板管理器的模板列表中，也就是应用程序对象的文档模板列表中。

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

<LI>CCommandLineInfo

首先，需要弄清楚类CcommandLineInfo，它是用来处理命令行信息的类，CWinApp:

areCommandLine调用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。

<LI>处理命令行命令

其次，分析 CWinApp:

rocessShellCommand(CCommandLineInfo& rCmdInfo)的流程，它处理命令行的命令，流程如图5-3所示。<IMG src="http://www.vczx.com/tutorial/mfc/image121.gif" align=left>
图5-4第三层表示根据命令类型进一步调用的函数，都是CWinApp或者派生类的成员函数。对于FILEDDE类型没有进一步的调用。
命令类型是FILENEW时，调用的函数就是标准命令ID_FILE_NEW对应的处理函数OnFileNew；命令类型是FILEOPEN时调用的函数是OpenDocumentFile，标准命令ID_FILE_OPEN的处理函数OnFileOpen的工作实际上就是由OpenDocumentFile完成的。函数FileNew、OpenDocumentFile导致了窗口、文档的创建。

<LI>OnFileNew

接着，分析 CWinApp::OnFileNew流程，如图5-5所示。<IMG src="http://www.vczx.com/tutorial/mfc/image122.gif" align=left>
图5-5的说明：
应用程序对象得到文档模板管理器指针，调用文档模板管理器的成员函数OnFileNew(m_pDocManager->OnFileNew())；模板管理器获取文档模板对象指针，调用文档模板对象的OpenDocumentFile 函数（pTemplate->OpenDocumentFile(NULL)）。如果模板管理器发现有多个文档模板，就弹出一个对话框让用户选择文档模板。这里和后面的图解中类似于CWinApp::、CDocManager::、CDocTemplate::等的函数类属限制并不表示直接源码中有这样的限制，而是通过指针或者指针的动态约束可以认定调用了某个类的成员函数，其正确性仅仅限于本书图解的MFC的缺省实现。
如图5-5所示，程序员可以覆盖有关虚拟函数或命令处理函数：如果程序员在自己的应用程序类中覆盖了OnFileNew，则可以实现完全不同的处理流程；一般情况下，不会从文档模板类派生新类，如果派生的话，可以覆盖CDocTemplate的虚拟函数。
</LI></OL>

abc · 发表于 2006-12-8 10:34:47

<OL>
<LI>
<

>控制条的窗口创建 
</LI></OL>
<

align=justify>CControlBar派生类实现了自己的窗口创建函数Create，CControlBar的PreCreateWindow被派生类的Create函数直接或者间接地调用。以CToolBar为例讨论窗口创建函数和创建过程。
<OL>
<

align=justify>
<LI>CToolBar的窗口创建函数Create

<

align=justify>Create函数实现如下：
<

align=justify>BOOL CToolBar::Create(CWnd* pParentWnd, DWORD dwStyle, UINT nID)
<

align=justify>{
<

align=justify>ASSERT_VALID(pParentWnd); // must have a parent
<

align=justify>ASSERT (!((dwStyle & CBRS_SIZE_FIXED) &&
<

align=justify>(dwStyle & CBRS_SIZE_DYNAMIC)));
<

align=justify>
// 保存dwStyle指定的CBRS_风格
m_dwStyle = dwStyle;
if (nID == AFX_IDW_TOOLBAR)
m_dwStyle |= CBRS_HIDE_INPLACE;

//去掉参数dwStyle包含的CBRS_风格
dwStyle &= ~CBRS_ALL;
//设置窗口风格
dwStyle |= 
CCS_NOPARENTALIGN|CCS_NOMOVEY|CCS_NODIVIDER|CCS_NORESIZE;

//初始化通用控制，可以导致InitCommonControl的调用
VERIFY(AfxDeferRegisterClass(AFX_WNDCOMMCTLS_REG));

//创建窗口，将调用PreCreateWindow,OnCreate, OnNcCreate等
CRect rect; rect.SetRectEmpty();
if (!CWnd::Create(TOOLBARCLASSNAME, NULL, dwStyle, 
rect, pParentWnd, nID))
return FALSE;

// Note: Parent must resize itself for control bar to be resized

return TRUE;
}
其中：
Create函数的参数1表示工具条的父窗口。参数2指定窗口风格和CBRS_风格，缺省值为 WS_CHILD | WS_VISIBLE | CBRS_TOP，其中WS_CHILD和WS_VISIBLE是窗口风格，CBRS_TOP是CBRS_风格。参数3指定工具条ID，缺省值为AFX_IDW_TOOLBAR（0X0E800或者59392）。如果还有多个工具栏要显示，在创建它们时则必须给每个工具栏指明ID。
首先，Create函数把参数2（dwStyle）指定的窗口风格和CBRS_风格分离出来，窗口风格保留在dwStyle中，CBRS_风格保存到成员变量m_dwStyle中。CToolBar:

reCreateWindow将进一步修改这些风格。
接着，Create函数调用了函数AfxDeferRegisterClass。它如果没有注册TOOLBARCLASSNAME表示的“窗口类”，就注册该类；否则，返回TRUE，表示已经注册。TOOLBARCLASSNAME表示的字符串是“ToolbarWindow32”，即“窗口类”名称。
然后，调用CWnd::Create(7个参数)使用“ToolbarWindow32”“窗口类”创建工具栏。
Create在创建窗口的过程中，用MFC的标准窗口过程取代原来的窗口过程，如同CFormView和CDialog窗口创建时窗口过程被取代一样，并发送WM_CREATE和WM_NCCREATE消息。
至于添加向工具栏添加按钮，则由函数LoadToolBar完成。在分析LoadToolBar函数之前，先讨论OnCreate、OnNcCreate等函数。

<LI>处理WM_CREATE消息

CControlBar提供了消息处理函数OnCreate来处理WM_CREATE消息。
int CControlBar::OnCreate(LPCREATESTRUCT lpcs)
{
//调用基类的实现
if (CWnd::OnCreate(lpcs) == -1)
return -1;
//针对工具栏，是否有Tooltip特性
if (m_dwStyle & CBRS_TOOLTIPS)
EnableToolTips();
//得到父窗口，并添加自身到其控制条列表中
CFrameWnd *pFrameWnd = (CFrameWnd*)GetParent();
if (pFrameWnd->IsFrameWnd())
{
m_pDockSite = pFrameWnd;
m_pDockSite->AddControlBar(this);
}
return 0;
}
如果需要支持Tooltips，则OnCreate调用EnableTooltips。
m_pDockSite是CControlBar的和泊位相关的成员变量，这里把它初始化为拥有工具栏的父边框窗口，该边框窗口把控制条加入其控制条列表m_listControlBars中。
在处理WM_CREATE之前，派生类先处理消息WM_NCCREAE。例如，CToolBar覆盖了OnNcCreate函数。

<LI>处理WM_NCCREATE消息

CToolBar对WM_NCCREATE消息的处理如下：
BOOL CToolBar::OnNcCreate(LPCREATESTRUCT lpCreateStruct)
{
if (!CControlBar::OnNcCreate(lpCreateStruct))
return FALSE;
// if the owner was set before the toolbar was created, set it now
if (m_hWndOwner != NULL)
DefWindowProc(TB_SETPARENT, (WPARAM)m_hWndOwner, 0);

DefWindowProc(TB_BUTTONSTRUCTSIZE, (WPARAM)sizeof(TBBUTTON), 0);
return TRUE;
}
CToolBar覆盖CcontrolBar的该函数用来设置工具条的所属窗口和描述工具条按钮结构的大小，这两个动作都是通过给工具条窗口发送消息来实现的。因为这些消息被送给控制窗口类的窗口过程（Windows提供的）来处理，所以直接调用DefWindowProc，省却了消息发送的过程。
在控制窗口创建之后，对于工具条来说，下一步就是向工具栏添加按钮。

<LI>向工具栏添加按钮

通过函数LoadToolBar完成向工具栏添加按钮的任务，其实现如下：
BOOL CToolBar:

oadToolBar(LPCTSTR lpszResourceName)
{
ASSERT_VALID(this);
ASSERT(lpszResourceName != NULL);

//查找并确认按钮位图、字符串等资源的位置
HINSTANCE hInst = AfxFindResourceHandle(lpszResourceName, RT_TOOLBAR);
HRSRC hRsrc = ::FindResource(hInst, lpszResourceName, RT_TOOLBAR);
if (hRsrc == NULL)
return FALSE;

//锁定资源
HGLOBAL hGlobal = LoadResource(hInst, hRsrc);
if (hGlobal == NULL)
return FALSE;

CToolBarData* pData = (CToolBarData*)LockResource(hGlobal);
if (pData == NULL)
return FALSE;
ASSERT(pData->wVersion == 1);

//复制与各个位图对应的命令ID到数组pItem
UINT* pItems = new UINT[pData->wItemCount];
for (int i = 0; i < pData->wItemCount; i++)
pItems = pData->items();
//添加按钮到工具栏，指定各个按钮对应的ID
BOOL bResult = SetButtons(pItems, pData->wItemCount);
delete[] pItems;

//设置按钮的位图
if (bResult)
{
// set new sizes of the buttons
CSize sizeimage(pData->wWidth, pData->wHeight);
CSize sizeButton(pData->wWidth + 7, pData->wHeight + 7);
SetSizes(sizeButton, sizeimage);

// load bitmap now that sizes are known by the toolbar control
bResult = LoadBitmap(lpszResourceName);
}

UnlockResource(hGlobal);
FreeResource(hGlobal);

return bResult;
}
LoadToolBar函数的参数指定了资源。ToolBar资源的类型是RT_TOOLBAR，ToolBar位图资源的类型是RT_BITMAP。
在RT_TOOLBAR类型的资源读入内存之后，可以用CToolBarData结构描述。一个这样的结构包括了ToolBar资源的如下信息：
工具条位图的版本，宽度，高度，个数，各个位图对应的命令ID。
然后，LoadToolBar把这些命令ID被复制到数组pItem中；根据位图宽度、高度形成按钮尺寸sizeButton和位图尺寸sizeimage。
接着，调用SetBottons添加按钮到工具栏，把各个按钮和命令ID对应起来；调用SetSizes设置按钮和位图的尺寸大小；调用LoadBitmap添加或者取代工具条的位图列表。这些动作都是调用工具栏“窗口类”的窗口过程完成的。例如，SetButtons的实现：
BOOL CToolBar::SetButtons(const UINT* lpIDArray, int nIDCount)
{
ASSERT_VALID(this);
ASSERT(nIDCount >= 1); // must be at least one of them
ASSERT(lpIDArray == NULL ||
AfxIsValidAddress(lpIDArray, sizeof(UINT) * nIDCount, FALSE));

//首先，删除工具条中现有的按钮
int nCount = (int)DefWindowProc(TB_BUTTONCOUNT, 0, 0);
while (nCount--)
VERIFY(DefWindowProc(TB_DELETEBUTTON, 0, 0));

if (lpIDArray != NULL)//命令ID数组非空
{
//添加新按钮
TBBUTTON button; memset(&button, 0, sizeof(TBBUTTON));
int iimage = 0;
for (int i = 0; i < nIDCount; i++)
{
button.fsState = TBSTATE_ENABLED;
if ((button.idCommand = *lpIDArray++) == 0)
{
//按钮之间分隔
button.fsStyle = TBSTYLE_SEP;
//按钮之间隔8个像素
button.iBitmap = 8;
}
else
{
//有位图和命令ID的按钮
button.fsStyle = TBSTYLE_BUTTON;
button.iBitmap = iimage++;//设置位图索引
}
//添加按钮
if (!DefWindowProc(TB_ADDBUTTONS, 1, (LPARAM)&button))
return FALSE;
}
}
else//命令ID数组空，添加空按钮
{
TBBUTTON button; memset(&button, 0, sizeof(TBBUTTON));
button.fsState = TBSTATE_ENABLED;
for (int i = 0; i < nIDCount; i++)
{
ASSERT(button.fsStyle == TBSTYLE_BUTTON);
if (!DefWindowProc(TB_ADDBUTTONS, 1, (LPARAM)&button))
return FALSE;
}
}
//记录按钮个数到成员变量m_nCount中
m_nCount = (int)DefWindowProc(TB_BUTTONCOUNT, 0, 0);

//稍后放置按钮
m_bDelayedButtonLayout = TRUE;

return TRUE;
}
函数的参数1是一个数组，数组的各个元素就是命令ID；参数2是按钮的个数。首先，SetButtons删除工具条原来的按钮；然后，添加新的按钮，若命令ID数组非空，则把每一个按钮和命令ID对应并分配位图索引，否则设置空按钮并返回FALSE；最后，记录按钮个数。
从SetButtons的实现可以看出，对工具条的所有操作都是通过工具条“窗口类”的窗口过程完成的，SetSizes、LoadBitmap也是如此，这里不作讨论。
</LI></OL>

abc · 发表于 2006-12-8 10:35:07

<OL>
<LI>
<

>状态栏和对话框工具栏的创建 
</LI></OL>
<

align=justify>至此，分析了MFC创建工具条窗口的过程。对于状态栏和对话框工具栏有类似的步骤，但也有不同之处。
<

align=justify>CStatusBar的Create使用“msctls_statusbar32”“窗口类”创建状态栏，窗口ID为AFX_IDW_STATUS_BAR(0XE801)，然后通过成员函数SetIndictors给状态栏分格，类似于给工具条添加按钮的过程，它实际上是通过状态栏“窗口类”的窗口过程完成的。
<

align=justify>CDialogBar的Create使用CreateDlg创建对话框工具栏，类似于CFormView的过程。在工具栏窗口创建之后，要添加到父窗口的工具栏列表中，这通过CControlBar::OnCreate完成。这样创建的结果导致窗口过程使用MFC的统一的窗口过程，相应“窗口类”的窗口过程也将在缺省处理中被调用，这一点如同CFormView和CDialog中所描述的。在初始化对话框的时候完成了各个控制按钮的添加。
<

align=justify>CStatusBar和CdialogBar都没有处理消息WM_NCCREATE。
<

align=justify>关于CStautsBar和CDialogBar创建过程的具体实现，这里不作详细讨论了。
<OL>
<OL>
<OL>
<

align=justify>
<LI>控制条的销毁

<

align=justify>描述了控制条的创建，顺便考察其销毁的设计。
<

align=justify>工具条、状态栏等这些控制窗口都要使用DestroyWindow来销毁，所有有关操作集中由CControlBar处理。CControlBar覆盖了虚拟函数DestroyWindow、PostNcDestroy和消息处理函数OnDestroy。
<

align=justify>当然，各个派生类的虚拟析构函数被实现。如果成员变量m_bAutoDelete为TRUE，则动态创建的MFC窗口将自动销毁。

<LI>处理控制条的位置

<OL>

<LI>计算控制条位置的过程和算法

工具条等控制条是作为一个子窗口在父边框窗口内显示的。为了处理控制条的布置(Layout)，首先需要计算出控制条的尺寸大小，这个工作被委派给工具条等控制窗口自己来完成。为此，CControlBar提供了两个函数来达到这个目的：CalcFixLayout，CalcDynamicLayout。这两个函数都是虚拟函数。各个派生类都覆盖了这两个或者其中一个函数，用来计算自身的尺寸大小。这些计算比较琐碎，在此不作详细讨论。其次，在父窗口位置或者大小变化时，控制条的大小和位置要作相应的调整。
下面，描述MFC确定或者更新工具条、状态栏等位置的步骤：
（1）边框窗口在必要的时候调用虚拟函数RecalcLayout来重新放置它的控制条和客户窗口，例如在创建窗口时、响应消息WM_SIZE时（见5.3.3.5节)边框窗口的初始化）。
（2）CFrameWnd::RecalcLayout调用CWnd的成员函数RepositionBars完成控制条窗口的重新放置。
（3）CWnd::RepositionBars作如下的处理：
RepositionBars首先给各个控制子窗口发送（Send）MFC内部使用的消息WM_SIZEPARENT，把窗口客户区矩形指针传递给它们，给它们一个机会来确认自己的尺寸。
然后，各个控制子窗口用OnSizeParent响应WM_SIZEPARENT消息；ControlBar实现了消息处理函数OnSizeParent，它调用CalcDynamicLayout等函数确定本窗口的大小，并从客户区矩形中减去自己的尺寸。
在所有的控制子窗口处理了OnSizeParent消息之后，RepositonBars利用返回的信息调用函数CalcWindowRect计算客户区窗口（MDI客户窗口、View等）的大小。
最后，调用::EndDeferWindowPos或者::SetWindowPos放置所有的窗口（控制子窗口和客户窗口）。
在窗口被放置的时候，发送消息WM_WINDOWPOSCHANGING和WM_WINDOWPOSCHANGED。MFC的实现中，控制窗口响应了前一个消息，消息处理函数是OnWindowPosChanging。CControlBar、CToolBar和CStatusBar等实现了消息处理函数OnWindowPosChanging。

上述处理过程所涉及的这些函数中，RecalcLayout是CFrameWnd定义的虚拟函数；RepostionBars是CWnd的成员函数；CalcaWindowRect是CWnd的虚拟函数；OnSizeParent是CControlBar定义的消息处理函数；OnWindowPosChanging是CToolbar、CStatusBar、CDockBar等CControlBar派生类定义的消息处理函数。
下面，对其中两个函数RecalcLayout和RepositionBars作一些分析。

<LI>CFrameWnd的虚拟函数RecalcLayout

RecalcLayout的实现如下：
void CFrameWnd::RecalcLayout(BOOL bNotify)
{
//RecalcLayout是否正在被调用
if (m_bInRecalcLayout)
return;

m_bInRecalcLayout = TRUE;
// clear idle flags for recalc layout if called elsewhere
if (m_nIdleFlags & idleNotify)
bNotify = TRUE;
m_nIdleFlags &= ~(idleLayout|idleNotify);

//与OLE相关的处理
#ifndef _AFX_NO_OLE_SUPPORT
// call the layout hook -- OLE support uses this hook
if (bNotify && m_pNotifyHook != NULL)
m_pNotifyHook->OnRecalcLayout();
#endif

//是否包含浮动(floating)控制条的边框窗口(CMiniFrameWnd类)
if (GetStyle() & FWS_SNAPTOBARS)
{
//计算控制条和边框窗口的位置、尺寸并设置它们的位置
CRect rect(0, 0, 32767, 32767);
RepositionBars(0, 0xffff, AFX_IDW_PANE_FIRST, reposQuery,
&rect, &rect, FALSE);
RepositionBars(0, 0xffff, AFX_IDW_PANE_FIRST, reposExtra,
&m_rectBorder, &rect, TRUE);
CalcWindowRect(&rect);
SetWindowPos(NULL, 0, 0, rect.Width(), rect.Height(),
SWP_NOACTIVATE|SWP_NOMOVE|SWP_NOZORDER);
}
else
//是普通边框窗口，则设置其所有子窗口的位置、尺寸
RepositionBars(0, 0xffff, AFX_IDW_PANE_FIRST,
reposExtra, &m_rectBorder);

//本函数处理完毕
m_bInRecalcLayout = FALSE;
}
该函数主要的目的是调用RepositionBars函数，它分两种情况来调用RepositionBars函数。一种情况是当前边框窗口为浮动控制条的包容窗口（微型边框窗口）时；另一种情况是当前边框窗口为普通边框窗口时。

<LI>CWnd的成员函数RepositionBars
</LI></OL>
RepositionBars的实现如下：
void CWnd::RepositionBars(UINT nIDFirst, UINT nIDLast, UINT nIDLeftOver,
UINT nFlags, LPRECT lpRectParam, LPCRECT lpRectClient, BOOL bStretch)
{
ASSERT(nFlags == 0 || nFlags == reposQuery || nFlags == reposExtra);

AFX_SIZEPARENTPARAMS layout;
HWND hWndLeftOver = NULL;

layout.bStretch = bStretch;
layout.sizeTotal.cx = layout.sizeTotal.cy = 0;
if (lpRectClient != NULL)
layout.rect = *lpRectClient; //从参数6得到客户区
else
//参数lpRectClient空，得到客户区域
GetClientRect(&layout.rect);

if (nFlags != reposQuery)
//准备放置各个子窗口(layout)
layout.hDWP = ::BeginDeferWindowPos(8); // reasonable guess
else
layout.hDWP = NULL; // not actually doing layout

//按一定顺序给各个控制条发送父窗口resize的消息；
//各个控制条窗口收到消息后，从客户区中扣除自己使用的区域；
//并且必要的话每个控制窗口调用:

eferWindowPos
//剩下的区域留给nIDLeftOver子窗口
for (HWND hWndChild = ::GetTopWindow(m_hWnd); hWndChild != NULL;
hWndChild = ::GetNextWindow(hWndChild, GW_HWNDNEXT))
{
UINT nIDC = _AfxGetDlgCtrlID(hWndChild);
CWnd* pWnd = CWnd::FromHandlePermanent(hWndChild);
//如果是指定的nIDLeftOver子窗口，则保存其窗口句柄；
//否则，是控制条窗口，给它们发送WM_SIZEPARENT消息
if (nIDC == nIDLeftOver)
hWndLeftOver = hWndChild;
else if (nIDC >= nIDFirst && nIDC <= nIDLast && pWnd != NULL)
//如果layout->hDWP非空， OnSizeParent则将执行窗口布置的操作
::SendMessage(hWndChild, WM_SIZEPARENT, 0, (LPARAM)&layout);
}

//如果是reposQuery，则得到客户区矩形，返回
if (nFlags == reposQuery)
{
ASSERT(lpRectParam != NULL);
if (bStretch)
::CopyRect(lpRectParam, &layout.rect);
else
{
lpRectParam->left = lpRectParam->top = 0;
lpRectParam->right = layout.sizeTotal.cx;
lpRectParam->bottom = layout.sizeTotal.cy;
}
return;
}

//其他情况下（reposDefault、reposExtra），则需要执行Layout操作

//处理hWndLeftOver(nIDLeftOver子窗口)
if (nIDLeftOver != 0 && hWndLeftOver != NULL)
{
CWnd* pLeftOver = CWnd::FromHandle(hWndLeftOver);
// allow extra space as specified by lpRectBorder
if (nFlags == reposExtra)
{
ASSERT(lpRectParam != NULL);
layout.rect.left += lpRectParam->left;
layout.rect.top += lpRectParam->top;
layout.rect.right -= lpRectParam->right;
layout.rect.bottom -= lpRectParam->bottom;
}
//基于layout.rect表示的客户尺寸计算出窗口尺寸
pLeftOver->CalcWindowRect(&layout.rect);
//导致函数:

eferWindowPos的调用
AfxRepositionWindow(&layout, hWndLeftOver, &layout.rect);
}

//给所有的窗口设置尺寸、位置(size and layout)
if (layout.hDWP == NULL || !::EndDeferWindowPos(layout.hDWP))
TRACE0("Warning: DeferWindowPos failed - low system resources.\n");
}
RepositionBars用来改变客户窗口中控制条的尺寸大小或者位置，其中：
参数1和参数2定义了需要重新放置的子窗口ID的范围，一般是0到0xFFFF。
参数3指定了一个子窗口ID，它拥有客户窗口剩下的空间，一般是AFX_IDW_PANE_FIRST，表示视的窗口ID。
参数4指定了操作类型，缺省是CWnd::ReposDefault，表示执行窗口放置操作，参数5不会用到；若取值CWnd::ReposQuery，则表示尝试进行窗口放置（Layout），但最后不执行这个操作，只是把参数5初始化成客户区的尺寸大小；若取值CWnd::ReposExtra，则把参数5的值加到参数2表示的子窗口的客户区域，并执行窗口放置操作。
参数6表示传递给函数的可用窗口客户区的尺寸，如果空则使用窗口客户区尺寸。
如果执行layout操作的话，该函数的核心处理就是：
首先，调用::BeginDeferWindowPos初始化一个Windows内部的多窗口位置结构（Multiple-window - position structure）hDWP；
然后，让各个子窗口逐个调用:

eferWindowPos，更新hDWP。在调用:

eferWindowPos之前，要作一个确定子窗口大小的工作。这些工作通过给各个控制子窗口发送消息WM_SIZEPARENT来完成。
控制子窗口通过函数OnSizeParent响应WM_SIZEPARENT消息，先确定自己的尺寸，然后，如果需要进行窗口布置(WM_SIZEPARENT消息参数lParam包含了一个非空的HDWP结构（lpLayout->hDWP）)，则OnSizeParent将调用AfxRepositionWindow函数计算本控制窗口的位置，结果保存到hDWP中。
在所有的控制窗口尺寸确定之后，剩下的留给窗口hWndLeftOver（如果存在的话）。确定了hWndLeftOver的大小之后，调用AfxRepositionWindow函数计算其位置，结果保存到hDWP中。
上面提到的函数AfxRepositionWindow间接调用了:

eferWindowPos。
最后，::EndDeferWindowPos，使用hDWP安排所有子窗口的位置和大小。

至于其他函数，如OnSizeparent、OnWindowPosChanging、CalcWindowRect，这里不作进一步的分析。
</LI></OL></OL></OL>

abc · 发表于 2006-12-8 10:35:31

<OL>
<LI>工具条、状态栏和边框窗口的接口 </LI>
<LI></LI>
<LI>
<DIV align=justify> </DIV></LI>
<LI>应用程序在状态栏中显示信息
</LI></OL>
<

align=justify>MFC内部通过给边框窗口发送消息WM_SETMESSAGESTRING、WM_POPMESSAGESTRING的方式在状态栏中显示信息。这两个消息在afxpriv.h里头定义。
<

align=justify>WM_SETMESSAGESTRING消息表示在状态栏中显示和某个ID对应的字符串信息或者指定的字符串信息，消息参数wParam指定了字符串资源ID，消息参数lParam指定了字符串指针，两个消息参数只有一个有用。一般，一个命令ID对应了一个字符串ID，对应的字符串是命令ID的说明。
<

align=justify>消息WM_POPMESSAGESTRING用来重新设置状态栏。
<

align=justify>这两个消息对应的消息处理函数分别是OnSetMessageString和OnPopMessageString，OnSetMessageString和OnPopMessageString分别实现如下：
<OL>
<

align=justify>
<LI>OnSetMessageString

<

align=justify>LRESULT CFrameWnd::OnSetMessageString(WPARAM wParam, LPARAM lParam)
<

align=justify>{
<

align=justify>//最近一次被显示的消息字符串IDS（一个消息对应的字符串）
<

align=justify>UINT nIDLast = m_nIDLastMessage;
<

align=justify>m_nFlags &= ~WF_NOPOPMSG;

//得到状态栏
CWnd* pMessageBar = GetMessageBar();
if (pMessageBar != NULL)
{
LPCTSTR lpsz = NULL;
CString strMessage;

//设置状态栏文本
if (lParam != 0) //指向一个字符串
{
ASSERT(wParam == 0); // can't have both an ID and a string
lpsz = (LPCTSTR)lParam; // set an explicit string
}
else if (wParam != 0)//一个字符串资源IDS
{
//打印预览时映射SC_CLOSE成AFX_IDS_PREVIEW_CLOSE;
if (wParam == AFX_IDS_SCCLOSE && m_lpfnCloseProc != NULL)
wParam = AFX_IDS_PREVIEW_CLOSE;

//得到资源ID所标识的字符串
GetMessageString(wParam, strMessage);
lpsz = strMessage;
}
//在状态栏中显示文本
pMessageBar->SetWindowText(lpsz);

// 根据最近一次选择的消息更新状态条所属窗口的有关记录
CFrameWnd* pFrameWnd = pMessageBar->GetParentFrame();
if (pFrameWnd != NULL)
{
//记录最近一次显示的消息字符串
pFrameWnd->m_nIDLastMessage = (UINT)wParam;
//记录最近一次Tracking的命令ID和字符串IDS
pFrameWnd->m_nIDTracking = (UINT)wParam;
}
}

m_nIDLastMessage = (UINT)wParam; // new ID (or 0)
m_nIDTracking = (UINT)wParam; // so F1 on toolbar buttons work
return nIDLast;
}
OnSetMessageString函数直接或者从ID从字符串资源中得到字符串指针。如果是从ID得到字符串指针，则函数GetMessageString被调用。
和命令ID对应的字符串由两部分组成，前一部分用于在状态栏显示，后一部分用于Tooltip显示，分隔符号是“\n”。例如，字符串ID_APP_EXIT（对应“退出”菜单、按钮）是“Exit Application\nExit”，当鼠标落在“退出”按钮上时，状态栏显示“Exit Application”，Tooltip显示“Exit”。根据这种格式，GetMessageString分离出第一部分的文本信息。至于第二部分的用途将在讨论Tooltip的章节将用到。
得到了字符串之后，OnSetMessageString调用状态栏的SetWindowText函数。SetWindowText导致消息WM_SETTEXT消息发送给状态栏，状态栏的消息处理函数OnSetText被调用，实际上等于调用了SetPaneText(0, lpsz)，即在状态栏的第0格中显示字符串lpsz的信息。对于工具栏来说，SetWindowText可以认为是SetPaneText(0, lpsz)的简化版本。
顺便指出，pMessageBar->GetParentFrame()返回主边框窗口，即使pMessageBar指向漂浮的工具条。关于泊位和漂浮，见后面13.2.5节的描述。
关于OnSetText，其实现如下：
LRESULT CStatusBar::OnSetText(WPARAM, LPARAM lParam)
{
ASSERT_VALID(this);
ASSERT(::IsWindow(m_hWnd));

int nIndex = CommandToIndex(0); //返回0
if (nIndex < 0)
return -1;

return SetPaneText(nIndex, (LPCTSTR)lParam) ? 0 : -1;
}

<LI>OnPopMessageString
</LI></OL>
LRESULT CFrameWnd::OnPopMessageString(WPARAM wParam, 
<DIR>
<DIR>
LPARAM lParam)</DIR></DIR>
{
//WF_NOPOPMSG表示边框窗口不处理WM_POPMESSAGESTRING
if (m_nFlags & WF_NOPOPMSG)
<DIR>
return 0;
</DIR>
//调用OnSetMessageString
return SendMessage(WM_SETMESSAGESTRING, wParam, lParam);
}
一般，在清除状态栏消息时，发送WM_POPMESSAGESTRING，通过消息参数wParam指定一个字符串资源，其ID 为AFX_IDS_IDLEMESSAGE，对应的字符串是“Ready”。
<OL>
<OL>
<OL>
<OL>

<LI>状态栏显示菜单项的提示信息

状态栏的一个重要作用是显示菜单命令或者工具条按钮的提示信息。本节讨论如何显示菜单命令的提示信息，关于工具条按钮在这方面的讨论见后面13.2.4.4章节。
显示菜单命令的提示信息，就是每当一个菜单项被选中之后，在状态栏显示该菜单的功能、用法等信息。这些信息以字符串资源的形式保存，字符串ID对应于菜单项的命令ID。
所以，必须处理菜单选择消息WM_MENUSELECT。CFrameWnd实现了消息处理函数OnMenuSelect，其实现如下：
void CFrameWnd::OnMenuSelect(UINT nItemID, 
UINT nFlags, HMENU /*hSysMenu*/)
{
CFrameWnd* pFrameWnd = GetTopLevelFrame();
ASSERT_VALID(pFrameWnd);

//跟踪被选中的菜单项
if (nFlags == 0xFFFF)
{
//取消菜单操作
m_nFlags &= ~WF_NOPOPMSG;
if (!pFrameWnd->m_bHelpMode)
m_nIDTracking = AFX_IDS_IDLEMESSAGE;
else
m_nIDTracking = AFX_IDS_HELPMODEMESSAGE;
//在状态栏显示
SendMessage(WM_SETMESSAGESTRING, (WPARAM)m_nIDTracking);
ASSERT(m_nIDTracking == m_nIDLastMessage);

// update right away
CWnd* pWnd = GetMessageBar();
if (pWnd != NULL)
pWnd->UpdateWindow();
}
else
{
//选中分隔栏、Popup子菜单或者没有选中一个菜单项
if (nItemID == 0 || nFlags & (MF_SEPARATOR|MF_POPUP))
{
// nothing should be displayed
m_nIDTracking = 0;
}
else if (nItemID >= 0xF000 && nItemID < 0xF1F0) // max of 31 SC_s
{
//系统菜单的菜单项被选中
m_nIDTracking = ID_COMMAND_FROM_SC(nItemID);
ASSERT(m_nIDTracking >= AFX_IDS_SCFIRST &&
m_nIDTracking < AFX_IDS_SCFIRST + 31);
}
else if (nItemID >= AFX_IDM_FIRST_MDICHILD)
{
//如果选中的菜单项表示一个MDI子窗口
m_nIDTracking = AFX_IDS_MDICHILD;
}
else
{
//选中了一个菜单项
m_nIDTracking = nItemID;
}
pFrameWnd->m_nFlags |= WF_NOPOPMSG;
}

// when running in-place, it is necessary to cause a message to
// be pumped through the queue.
if (m_nIDTracking != m_nIDLastMessage && GetParent() != NULL)
PostMessage(WM_KICKIDLE);
}
OnMenuSelect的作用在于跟踪当前选中的菜单项，把菜单项对应的ID保存在CFrameWnd的成员变量m_nIDTracking中。
如果菜单项没有选中，或者选中的是一个子菜单，则设置nIDTracking为0。
如果选中的是系统菜单，则把系统菜单ID转换成一个对应的命令ID；保存该值到nIDTracking中。
如果选中的菜单是MDI子窗口创建时添加的（用来表示MDI子窗口），则转换菜单ID为AFX_IDS_MDICHILD，所有对应MDI子窗口的菜单项都使用AFX_IDS_MDICHILD，保存该值到nIDTracking中。
其他情况，就是选中菜单项的ID，把它保存到nIDTracking中。

跟踪被选择的菜单项并保存其ID在m_nIDTracking中，OnEnterIdle将用到m_nIDTracking。OnEnterIlde是消息WM_ENTERIDLE的处理函数，CFrameWnd的实现如下。
void CFrameWnd::OnEnterIdle(UINT nWhy, CWnd* pWho)
{
CWnd::OnEnterIdle(nWhy, pWho);

//若不是因为菜单选择进入该函数
//或者当前跟踪到的菜单项ID是最近一次处理的，则返回
if (nWhy != MSGF_MENU || m_nIDTracking == m_nIDLastMessage)
return;

//将发送消息WM_SETMESSAGETEXT
//在状态栏显示m_nIDTracking对应的字符串
SetMessageText(m_nIDTracking);
ASSERT(m_nIDTracking == m_nIDLastMessage);
}
当一个对话框或者菜单被显示的时候，Windows发送WM_ENTERIDLE消息。消息参数wParam取值为MSGF_DIALOGBOX或者MSGF_MENU。前者表示显示对话框时发送该消息，这时消息参数lParam表示对话框的句柄；后者表示显示菜单时发送该消息，这时消息参数lParam表示菜单的句柄。
经过消息映射，wParam的值传递给OnEnterIdle的参数nWhy，参数lParam的值传给参数who。如果参数1取值为MSGF_MENU，并且OnEnterIdle最近一次在菜单显示被调用时的菜单ID不同于这一次，则调用SetMessageText在状态栏显示对应ID命令的字符串，并且记录当前菜单ID到变量m_nIDTracking中（见消息处理函数OnSetMessageText）。
这样，在菜单选择期间，用户选择的菜单项ID被OnMenuSelect记录，在消息WM_ENTERIDLE处理时在状态栏显示ID命令的提示。
</LI></OL></OL></OL></OL>

abc · 发表于 2006-12-8 10:36:07

<OL>
<LI>
<

>控制条的消息分发处理 
</LI></OL>
<

align=justify>工具条（包括对话框工具条）是一个子窗口，它们可以响应各种消息。如果按标准的Windows消息和命令消息的分发途径，一些消息不能送到拥有工具条的边框窗口，因为这些消息都将被工具条（对话框工具条）处理掉。所以，CControlBar覆盖了虚拟函数PreTranslateMessage和WindowProc以便实现特定的消息分发路径。
<OL>
<

align=justify>
<LI>WindowProc

<

align=justify>CControlBar 的WindowProc实现了如下的消息分发路径：
<

align=justify>用户对控制条的输入消息或者分发给CControlBar及其派生类处理，或者送给拥有控制条的边框窗口处理，或者送给Windows控制“窗口类”的窗口过程处理。
<

align=justify>WindowProc的实现如下：
<

align=justify>LRESULT CControlBar::WindowProc(UINT nMsg, 
<

align=justify>WPARAM wParam, LPARAM lParam)
<

align=justify>{
<

align=justify>ASSERT_VALID(this);

LRESULT lResult;
switch (nMsg)
{
//本函数处理以下消息
case WM_NOTIFY:
case WM_COMMAND:
case WM_DRAWITEM:
case WM_MEASUREITEM:
case WM_DELETEITEM:
case WM_COMPAREITEM:
case WM_VKEYTOITEM:
case WM_CHARTOITEM:
//首先，工具条处理上述消息，如果没有处理，则接着给所属边框窗口处理
if (OnWndMsg(nMsg, wParam, lParam, &lResult))
return lResult;
else
return GetOwner()->SendMessage(nMsg, wParam, lParam);
}
}
// 最后，给基类CWnd，按缺省方式处理
lResult = CWnd::WindowProc(nMsg, wParam, lParam);
return lResult;
}
从上述实现可以看出，对于case范围内的一些消息，如WM_COMMAND、WM_NOTIFY等，控制条如果不能处理，则优先分发给其父窗口（边框窗口）处理，然后进入缺省处理，对于其他消息直接调用基类CWnd的实现（缺省处理）。基于这样的机制，可以把用户对工具条按钮或者对话框工具条内控制的操作解释成相应的命令消息，执行对应的命令处理。
对于工具条，当用户选中某个按钮时（鼠标左键弹起，消息是WM_LBUTTONUP），工具条窗口接收到WM_LBUTTONUP消息，该消息不在CControlBar::WindowProc特别处理的消息范围内，于是进行缺省处理，也就是说，把该消息派发给控制条对应的Windows控制的窗口过程处理（即被MFC统一窗口过程所取代的原窗口过程），该窗口过程则把该消息转换成一条命令消息WM_COMMAND，命令ID就是选中按钮对应的ID，然后，发送该命令消息给拥有工具条的边框窗口，导致相应的命令处理函数被调用。
对于对话框工具条，当工具条的某个控制子窗口被选中之后，则产生一条命令通知消息WM_COMMAND，wParam是控制子窗口的ID。CControlBar::WindowProc处理该消息。WindowProc首先调用OnWndMsg把消息发送给对话框工具条或者对话框工具条的基类处理，如果没有被处理的话，则OnWndMsg返回FALSE。接着，WindowPoc把命令消息传递给父窗口（边框窗口）处理。由于工具条的控制窗口的ID对应的是命令ID，所以，这条WM_COMMAND消息传递给边框窗口时，被解释成一个命令消息，相应的命令处理函数被调用。

<LI>PreTranslateMessage
</LI></OL>
CControlBar覆盖PreTranslateMessage函数，主要是为了在光标落在工具条按钮上时显示FLYBY信息，并且让对话框工具条过滤Dialog消息。
BOOL CControlBar:

reTranslateMessage(MSG* pMsg)
{
ASSERT_VALID(this);
ASSERT(m_hWnd != NULL);

//过滤Tooltip消息
if (CWnd:

reTranslateMessage(pMsg))
<DIR>
return TRUE; //是Tooltip消息，已经被处理
</DIR>
UINT message = pMsg->message;
//控制条的父窗口，对工具条和对话框工具条，总是创建它的边框窗口
CWnd* pOwner = GetOwner();

//必要的话，在状态条显示工具栏按钮的提示
if (((m_dwStyle & CBRS_FLYBY) ||
<DIR>
message == WM_LBUTTONDOWN || message == WM_LBUTTONUP) &&
((message >= WM_MOUSEFIRST && message <= WM_MOUSELAST) ||
(message >= WM_NCMOUSEFIRST && 
<DIR>
message <= WM_NCMOUSELAST)))</DIR></DIR>
{
<DIR>
_AFX_THREAD_STATE* pThreadState = AfxGetThreadState();

//确认鼠标在工具栏的哪个按钮上
CPoint point = pMsg->pt;
ScreenToClient(&point);
TOOLINFO ti; memset(&ti, 0, sizeof(TOOLINFO));
ti.cbSize = sizeof(TOOLINFO);
int nHit = OnToolHitTest(point, &ti);
if (ti.lpszText != LPSTR_TEXTCALLBACK)
<DIR>
free(ti.lpszText);</DIR>
BOOL bNotButton =
<DIR>
message == WM_LBUTTONDOWN && (ti.uFlags & TTF_NOTBUTTON);</DIR>
if (message != WM_LBUTTONDOWN && GetKeyState(VK_LBUTTON) < 0)
<DIR>
nHit = pThreadState->m_nLastStatus;
</DIR>
//更新状态栏的提示信息
if (nHit < 0 || bNotButton)
{
<DIR>
if (GetKeyState(VK_LBUTTON) >= 0 || bNotButton)
{
SetStatusText(-1);
KillTimer(ID_TIMER_CHECK);
}</DIR>
}
else
{
<DIR>
if (message == WM_LBUTTONUP)
{
<DIR>
<DIR>
SetStatusText(-1);
ResetTimer(ID_TIMER_CHECK, 200);</DIR></DIR>
}</DIR>
else
{
<DIR>
if ((m_nStateFlags & statusSet) || GetKeyState(VK_LBUTTON) < 0)
SetStatusText(nHit);</DIR>
else if (nHit != pThreadState->m_nLastStatus)
<DIR>
ResetTimer(ID_TIMER_WAIT, 300);</DIR>
}</DIR>
}
pThreadState->m_nLastStatus = nHit;
}

// don't translate dialog messages when in Shift+F1 help mode
CFrameWnd* pFrameWnd = GetTopLevelFrame();
if (pFrameWnd != NULL && pFrameWnd->m_bHelpMode)
<DIR>
return FALSE;
</DIR>
//在IsDialogMessage之前调用边框窗口的PreTranslateMessage，
//给边框窗口一个处理快捷键的机会
while (pOwner != NULL)
{
<DIR>
// allow owner & frames to translate before IsDialogMessage does
if (pOwner->PreTranslateMessage(pMsg))
<DIR>
return TRUE;
</DIR>
// try parent frames until there are no parent frames
pOwner = pOwner->GetParentFrame();</DIR>
}

//过滤给对话框的消息和来自子窗口的消息
return PreTranslateInput(pMsg);
}

函数PreTranslateMessage主要是针对工具栏的，用来处理工具栏的CBRS_FLYBY特征。
对于对话框工具栏，也可以有CBRS_FLYBY特征。但在这种情况下，还需要把一些用户键盘输入解释成对话框消息。为了防止快捷键被解释成对话框消息，在调用函数PreTranslateInput之前，必须调用所有父边框窗口的PreTranslateMessage，给父边框窗口一个机会处理用户的输入消息，判断快捷键是否被按下。
关于Tooltip和本PreTranslateMessage函数处理Tooltip的详细解释见下一节的讨论。
<OL>
<OL>
<OL>
<OL>

<LI>Tooltip
</LI></OL></OL></OL></OL>
工具条（或对话框工具条）如果指定了CBRS_TOOLTIPS风格（创建时指定或者创建后用SetBarStyle设置），则当鼠标落在某个按钮上（或者对话框的子控制窗口）时，在鼠标附近弹出一个文本框──Tooltip提示窗口。
如果还指定了CBRS_FLYBY风格，则还在状态栏显示和按钮（或子控制窗口）ID对应的字符串信息。当然，鼠标左键在某个按钮（或子控制窗口）按下时，也要在状态栏显示按钮的提示信息，当左键弹起时，则重置状态栏的状态。
如前所述，Tooltip窗口是Windows控制窗口。MFC使用了CToolTipCtrl类封装Tooltip的HWND窗口。在一个线程的生存期间，至多拥有一个Tooltip窗口，该窗口对象的指针保存在线程状态的成员变量m_pToolTip中。线程状态类AFX_THREAD_STATE的析构函数如果检测到m_pToolTip，则销毁MFC窗口对象和相应的Windows窗口对象。
<OL>

<LI>CWnd对Tooltip消息的预处理

为了支持Tooltip显示，CWnd提供了以下函数：EnableTooltip，CancelTooltip，PreTranslateMessage，FilterTooltipMessage，OnToolHitTest。
EnableTooltip设置CBRS_TOOLTIP风格，相反CancelTootip取消这种风格。
PreTranslateMessage调用了FilterTooltipMessage过滤Tooltip消息。
OnToolHitTest是一个由CWnd定义的虚拟函数。CToolBar通过覆盖该函数，来检测对话框工具栏的控制子窗口或者工具栏按钮是否被选中、哪个被选中。

CWnd的PreTranslateMessage在4.5节讨论过，它的实现如下：
BOOL CWnd:

reTranslateMessage(MSG* pMsg)
{
//处理Tooltip消息
AFX_MODULE_STATE* pModuleState = _AFX_CMDTARGET_GETSTATE();
if (pModuleState->m_pfnFilterToolTipMessage != NULL)
//导致调用FilterTooltipMessage
(*pModuleState->m_pfnFilterToolTipMessage)(pMsg, this);

//不是Tooltip消息
return FALSE;
}
至于为什么MFC在模块状态中保存一个处理Tooltip消息的函数地址，通过该函数调用FilterTooltipMessage，是因为Tooltip窗口是模块线程局部有效的。
FilterTooltipMessage检测是否是Tooltip消息。如果是，在必要时创建一个CTooltipCtrl对象和对应的HWND，调用OnToolHitTest确定被选中的按钮或者控制的ID，接着弹出Tooltip窗口。
其他函数和CTooltipCtrl这里不作详细论述了。

<LI>处理TTN_NEEDTEXT通知消息

Tooltip窗口在弹出之前，它给工具条（或者对话框工具栏）的父窗口发送通知消息TTN_NEEDTEXT，请求得到要显示的文本。
CFrameWnd类处理了TTN_NEEDTEXT通知消息，消息处理函数是OnToolTipText。
消息映射的定义：
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTW, 0, 0xFFFF, OnToolTipText)
ON_NOTIFY_EX_RANGE(TTN_NEEDTEXTA, 0, 0xFFFF, OnToolTipText)
这里，使用了扩展消息映射宏把子窗口ID在0和0xFFFF之间的控制条窗口的通知消息TTN_NEEDTEXTA和TTN_NEEDTEXTW映射到函数OnToolTipText。
消息映射的实现：
BOOL CFrameWnd::OnToolTipText(UINT, NMHDR* pNMHDR, LRESULT* pResult)
{
ASSERT(pNMHDR->code == TTN_NEEDTEXTA || 
pNMHDR->code == TTN_NEEDTEXTW);

//让上一层的边框窗口优先处理该消息
if (GetRoutingFrame() != NULL)
return FALSE;

//分ANSI and UNICODE两个处理版本
TOOLTIPTEXTA* pTTTA = (TOOLTIPTEXTA*)pNMHDR;
TOOLTIPTEXTW* pTTTW = (TOOLTIPTEXTW*)pNMHDR;
TCHAR szFullText[256];
CString strTipText;
UINT nID = pNMHDR->idFrom;
//如果idFrom是一个子窗口，则得到其ID。
if (pNMHDR->code == TTN_NEEDTEXTA && 
(pTTTA->uFlags & TTF_IDISHWND) ||
pNMHDR->code == TTN_NEEDTEXTW &&
(pTTTW->uFlags & TTF_IDISHWND))
{
//idFrom是工具条的句柄
nID = _AfxGetDlgCtrlID((HWND)nID);
}

if (nID != 0) //若是0，为一分隔栏，不是按钮
{
//得到nID对应的字符串
AfxLoadString(nID, szFullText);
//从上面得到的字符串中取出Tooltip使用的文本
AfxExtractSubString(strTipText, szFullText, 1, '\n');
}
//复制分离出的文本
#ifndef _UNICODE
if (pNMHDR->code == TTN_NEEDTEXTA)
lstrcpyn(pTTTA->szText, strTipText, _countof(pTTTA->szText));
else
_mbstowcsz(pTTTW->szText, strTipText, _countof(pTTTW->szText));
#else
if (pNMHDR->code == TTN_NEEDTEXTA)
_wcstombsz(pTTTA->szText, strTipText, _countof(pTTTA->szText));
else
lstrcpyn(pTTTW->szText, strTipText, _countof(pTTTW->szText));
#endif
*pResult = 0;

//显示Tooltip窗口
::SetWindowPos(pNMHDR->hwndFrom, HWND_TOP, 0, 0, 0, 0,
SWP_NOACTIVATE|SWP_NOSIZE|SWP_NOMOVE);

return TRUE; //消息处理完毕
}
OnToolTipText是一个扩展映射宏定义的消息处理函数，所以有一个UINT参数并且返回BOOL类型的值。不过，由于第二个参数（NMHDR）的idFrom域包含了有关信息，所以第一个UINT类型的参数没有用上。
OnToolTipText也是一个处理通知消息的例子。其中，通知参数wParam的结构如4.4.4.2节所述，具体如下：
typedef struct {
NMHDR hdr; //WM_NOTIFY消息要求的头
LPTSTR lpszText; //接收工具条按钮对应文本的缓冲区
WCHAR szText[80]; //接收Tooltip显示文本的缓冲区
HINSTANCE hinst; //包含了szText的实例句柄
UINT uflags; //标识了NMHDR的idFrom成员的意义
} TOOLTIPTEXT, FAR *LPTOOLTIPTEXT;
uflags如果等于TTF_IDISHWND，则表示通知消息来自对话框工具条的一个子窗口，而不是包含工具条按钮。
OnToolTipText根据子窗口ID或者工具条按钮对应的ID，得到字符串ID。如前所述，字符串ID由两部分组成，第二部分用于Tooltip显示，分隔符号是“\n”。根据这种格式OnToolTipText分离出Tooltip文本。
得到了Tooltip文本之后，可以有三种方法返回文本信息：把文本信息复制到szText缓冲区；把文本地址复制到lpszText；复制字符串资源的ID到lpszText、复制包含资源的实例句柄到hint。本函数采用了第一种方法。
在得到了返回的Tooltip文本之后，该文本在Tooltip窗口中被显示出来。
其他的OnToolHist等函数的实现不作详细的解释了。下面，讨论CBRS_FLYBY风格的实现。
</LI></OL>

abc · 发表于 2006-12-8 10:37:47

<OL>
<LI>
<

>CBRS_FLYBY风格的实现 
</LI></OL>
<

align=justify>CBRS_FLYBY是MFC提供的特征。当鼠标落在工具条按钮（或者对话框工具条的子窗口）上且稳定300ms后，在状态栏显示对应的提示信息。如果选中某个按钮或者子窗口（鼠标左键按下），则在相应命令消息处理之前在状态栏显示有关提示信息，之后（鼠标左键弹起），重新设置状态栏的状态信息。
<

align=justify>为了支持这种特征，CControlBar覆盖虚拟函数PreTranslateMessage来处理和CBRS_FLYBY相关的消息，该函数前面已经讨论过，这里解释它如何处理CBRS_FLYBY特征。
<

align=justify>如果同时具备
<

align=justify>条件1：控制条具有CBRS_FLYBY特征或者当前消息是WM_LBUTTONUP或者WM_LBUTTONDOWN。
<

align=justify>条件2：当前消息是鼠标消息（在WM_MOUSEFIRST和WM_MOUSELAST之间或者在WM_NCMOUSEFIRST和WM_NCMOUSELAST之间）。
<

align=justify>则进行FLYBY处理。
<

align=justify>首先，调用OnToolHitTest测试用户是否选中了工具条的按钮或者子窗口；
<

align=justify>如果没有按钮或者子窗口被选中，则重新设置状态栏的状态，取消曾经设置的Check定时器。重置状态栏的状态时调用了SetStatusText（int nHit）函数，它是CControlBar内部使用的函数，若nHit等于-1，它向父窗口发送WM_POPMESSAGETEXT，消息参数是AFX_IDS_IDLEMESSAGE，结果导致状态栏显示“Ready”字样；否则发送WM_SETMESSAGETEXT消息，wParm设置为nHit，结果导致在状态栏显示ID为nHit的字符串。
<

align=justify>如果有按钮或者子窗口被选中，若左键弹起，则重新设置状态栏信息，取消Wait定时器，并重新设置Check定时器，定时是200ms；若左键按下，则在状态栏显示消息ID对应的提示信息；若是其他鼠标消息，如果当前鼠标所在按钮（子窗口）不同于最近一次，则取消Check定时器，重新设置Wait定时器，定时300毫秒。
CControlBar覆盖了消息处理函数OnTimer，在指定时间之后，检查鼠标位置，如果鼠标还在某个按钮或者子窗口上，则在状态条显示提示信息。Wait定时器在等待之后准备在状态条显示信息，触发一次后被取消；Check定时器在等待之后，判断是否需要取消状态条当前显示的信息，重新设置状态条，若这样的话，同时也取消Check定时器。
注意，这些鼠标消息被处理之后，并没有终止，它们将继续被发送给控制条的窗口过程处理。
至此，CBRS_FLYBY特征的支持实现描述完毕。
<OL>
<OL>
<OL>
<OL>

<LI>禁止和允许
</LI></OL></OL></OL></OL>
在MFC下，工具条、状态条还有一个重要的特征，就是自动地根据条件禁止或者允许使用某个按钮、窗格等。在4.4.5节命令消息的处理中，曾详细讨论了其实现原理，现在，详细地分析所涉及函数是如何实现的。有关的消息处理函数和虚拟函数如下。
处理WM_INITIALUPDATE消息的OnInitialUpdate；
处理WM_IDLEUPDATECMDUI消息的OnIdleUpdateCmdUI；
虚拟函数OnUpdateCmdUI。
回顾5.3.3.5节，在边框窗口的创建之后，给所有的子窗口发送初始化消息，控制子窗口用OnInitialUpdate响应它，调用OnIdleUpdateCmdUI完成状态的初始化。
OnIdleUpdateCmdUI还在IDLE处理时进行状态的更新处理，它生成用于处理状态更新消息的命令目标pTarget，然后调用虚拟函数OnUpdateCmdUI(pTarget，…)来更新工具栏或者状态栏的状态。
CControlBar的子类都实现了自己的OnUpdateCmdUI函数，用该函数生成适当的CCmdUI对象state，然后调用CCmdUI的DoUpdate（pTarget，…）给pTarget所指对象发送状态更新消息。为了完成具体的状态更新，从CCmdUI派生出CToolCmdUI和CStatusCCmUI，它们实现了自己的Enable、SetCheck等等。
<OL>

<LI>初始化控制窗口

CControlBar使用OnInitialUpdate消息处理函数初始化控制窗口的状态。
void CControlBar::OnInitialUpdate()
{
//在窗口显示之前，更新状态
OnIdleUpdateCmdUI(TRUE, 0L);
}
CControlBar实现了OnInitialUpdate函数，通过它来处理WM_INITIALUPDATE消息。各个子类不必覆盖该消息处理函数。

<LI>处理Idle消息更新工具条状态

CControlBar使用OnIdleUpdateCmdUI消息处理函数处理IDLE消息。
LRESULT CControlBar::OnIdleUpdateCmdUI(WPARAM wParam, LPARAM)
{
// handle delay hide/show
BOOL bVis = GetStyle() & WS_VISIBLE;
UINT swpFlags = 0;
if ((m_nStateFlags & delayHide) && bVis)
swpFlags = SWP_HIDEWINDOW;
else if ((m_nStateFlags & delayShow) && !bVis)
swpFlags = SWP_SHOWWINDOW;
m_nStateFlags &= ~(delayShow|delayHide);
if (swpFlags != 0)
{
SetWindowPos(NULL, 0, 0, 0, 0, swpFlags|
SWP_NOMOVE|SWP_NOSIZE|SWP_NOZORDER|SWP_NOACTIVATE);
}

// the style must be visible and if it is docked
// the dockbar style must also be visible
if ((GetStyle() & WS_VISIBLE) &&
(m_pDockBar == NULL || (m_pDockBar->GetStyle() & WS_VISIBLE)))
{
//得到父边框窗口，状态更新消息将发送给它
CFrameWnd* pTarget = (CFrameWnd*)GetOwner();
if (pTarget == NULL || !pTarget->IsFrameWnd())
pTarget = GetParentFrame();
if (pTarget != NULL)
OnUpdateCmdUI(pTarget, (BOOL)wParam);
}
return 0L;
}
OnIdleUpdateCmdUI或者在初始化时被OnInitialUpdate调用，或者作为消息处理函数来处理WM_IDLEUPDATECMDUI消息。
CControlBar实现了OnIdleUpdateCmdUI函数，把具体的用户界面更新动作委托给虚拟函数OnUpdateCmdUI完成。
由于各个用户界面的特殊性，所以CControlBar本身没有实现OnUpdateCmdUI，而是留给各个派生类去实现。例如，CToolBar覆盖了OnUpdateCmdUI，其实现如下：
void CToolBar::OnUpdateCmdUI(CFrameWnd* pTarget, BOOL bDisableIfNoHndler)
{
//定义一个CCmdUI对象，CToolCmdUI派生于CCmdUI
CToolCmdUI state;
//给CCmdUI的各个成员赋值
state.m_pOther = this;

//得到总的按钮数目
state.m_nIndexMax = (UINT)DefWindowProc(TB_BUTTONCOUNT, 0, 0);
//逐个按钮进行状态更新
for (state.m_nIndex = 0; state.m_nIndex < state.m_nIndexMax; state.m_nIndex++)
{
//获取按钮状态信息
TBBUTTON button;
_GetButton(state.m_nIndex, &button);
//得到按钮的ID
state.m_nID = button.idCommand;

// ignore separators
if (!(button.fsStyle & TBSTYLE_SEP))
{
//优先让CToolBar对象处理状态更新消息
if (CWnd::OnCmdMsg(state.m_nID, 
CN_UPDATE_COMMAND_UI, &state, NULL))
continue;//处理了更新消息，更新下一个按钮

//CToolBar没有处理，将发送给pTarget处理状态更新消息
//第二个参数bDisableIfNoHndler往下传
state.DoUpdate(pTarget, bDisableIfNoHndler);
}
}

//更新加到控制条中的对话框控制的状态
UpdateDialogControls(pTarget, bDisableIfNoHndler);
}
CToolBar的OnUpdateCmdUI函数完成工具条按钮的状态更新。它接受两个参数，参数1表示接收状态更新命令消息的对象，由CControlBar的函数OnIdleUpdateCmdUI传递过来，一般是边框窗口对象；参数2表示如果某条命令消息没有处理函数时，对应的用户接口对象是否被禁止。
OnUpdateCmdUI通过发送状态更新通知消息，逐个更新按钮的状态。更新消息首先让工具条对象处理，如果没有处理的话，送给边框窗口对象处理，导致状态更新命令消息的处理函数被调用，参见4.4.5节。
CStatusBar的OnUpdateCmdUI类似于此。
CDialogBar的OnUpdateCmdUI则调用了虚拟函数UpdateDialogControls来进行状态更新，CWnd提供了该函数的实现，过程类似于CToolBar的函数OnUpdateCmdUI。
</LI></OL>

abc · 发表于 2006-12-8 10:38:30

<OL>
<LI>
<

>菜单项的自动更新 
</LI></OL>
<

align=justify>那么，菜单项的自动更新如何实现的呢？OnInitMenuPopup在菜单项状态的自动更新中曾经被提到，其实现如下：
<

align=justify>void CFrameWnd::OnInitMenuPopup(CMenu* pMenu, UINT, BOOL bSysMenu)
<

align=justify>{
<

align=justify>AfxCancelModes(m_hWnd);
<

align=justify>
<

align=justify>if (bSysMenu)
<DIR>
<

align=justify>return; // don't support system menu
<

align=justify></DIR>
<

align=justify>ASSERT(pMenu != NULL);
// check the enabled state of various menu items

CCmdUI state;
state.m_pMenu = pMenu;
ASSERT(state.m_pOther == NULL);
ASSERT(state.m_pParentMenu == NULL);

//判断菜单是否在顶层菜单(top level menu)中弹出，如果这样
//则设置m_pParentMenu指向顶层菜单，否则m_pParentMenu
//为空，表示它是一个二级弹出菜单
HMENU hParentMenu;
//是否是浮动式的弹出菜单（floating pop up menu）
if (AfxGetThreadState()->m_hTrackingMenu == pMenu->m_hMenu)
<DIR>
state.m_pParentMenu = pMenu; // parent == child for tracking popup</DIR>
else if ((hParentMenu = ::GetMenu(m_hWnd)) != NULL)//
{
<DIR>
CWnd* pParent = GetTopLevelParent();
// child windows don't have menus -- need to go to the top!
//得到顶层窗口的菜单
if (pParent != NULL &&
<DIR>
(hParentMenu = ::GetMenu(pParent->m_hWnd)) != NULL)</DIR>
{
<DIR>
int nIndexMax = ::GetMenuItemCount(hParentMenu);
//确定顶层窗口的菜单是否包含本菜单项
for (int nIndex = 0; nIndex < nIndexMax; nIndex++)
{
<DIR>
<DIR>
if (::GetSubMenu(hParentMenu, nIndex) == pMenu->m_hMenu)
{
<DIR>
//顶层窗口菜单是本菜单的父菜单
state.m_pParentMenu = CMenu::FromHandle(hParentMenu);
break;</DIR>
}</DIR></DIR>
}</DIR>
}</DIR>
}

//本菜单的菜单项(menu item)数量
state.m_nIndexMax = pMenu->GetMenuItemCount();
//对所有菜单项逐个进行状态更新
for (state.m_nIndex = 0; state.m_nIndex < state.m_nIndexMax;
state.m_nIndex++)
{
<DIR>
state.m_nID = pMenu->GetMenuItemID(state.m_nIndex);
if (state.m_nID == 0)
<DIR>
continue; // menu separator or invalid cmd - ignore it
</DIR>
ASSERT(state.m_pOther == NULL);
ASSERT(state.m_pMenu != NULL);
if (state.m_nID == (UINT)-1)
{
<DIR>
// 可能是一个popup菜单，得到其第一个子菜单项目
state.m_pSubMenu = pMenu->GetSubMenu(state.m_nIndex);
if (state.m_pSubMenu == NULL ||
<DIR>
<DIR>
(state.m_nID = state.m_pSubMenu->GetMenuItemID(0)) == 0 ||
state.m_nID == (UINT)-1)</DIR></DIR>
{
<DIR>
<DIR>
continue; // 找不到popup菜单的子菜单项</DIR></DIR>
}
//popup菜单不会被自动的禁止
state.DoUpdate(this, FALSE); </DIR>
}
else
{
<DIR>
//正常的菜单项，若边框窗口的m_bAutoMenuEnable设置为
//TURE且菜单项非系统菜单，则自动enable/disable该菜单项
state.m_pSubMenu = NULL;
state.DoUpdate(this, m_bAutoMenuEnable && state.m_nID < 0xF000);</DIR>
}

//经过菜单状态的更新处理，可能增加或删除了一些菜单项
UINT nCount = pMenu->GetMenuItemCount();
if (nCount < state.m_nIndexMax)
{
<DIR>
state.m_nIndex -= (state.m_nIndexMax - nCount);
while (state.m_nIndex < nCount &&
<DIR>
<DIR>
pMenu->GetMenuItemID(state.m_nIndex) == state.m_nID)</DIR></DIR>
{
<DIR>
<DIR>
state.m_nIndex++;</DIR></DIR>
}</DIR>
}
state.m_nIndexMax = nCount;
}</DIR>
}
菜单弹出之前，发送WM_INITMENUPOPUP消息，OnInitMenuPopup消息处理函数被调用，逐个更新菜单项目（menu item）的状态。程序员可以处理它们对应的状态更新消息，禁止/允许菜单项目被使用（disable/enable)，在菜单项目上打钩或者取消（checked/unchecked），等等。
<OL>
<OL>
<OL>
<OL>

<LI>显示或者隐藏工具栏和状态栏
</LI></OL></OL></OL></OL>
这里讨论显示或者隐藏工具栏、状态栏的操作，以及工具栏、状态栏被显示/隐藏时，相关的两个菜单项ID_VIEW_STATUS_BAR、ID_VIEW_TOOLBAR的状态更新。这两个菜单命令及对应的状态更新命令是标准命令消息所包含的。MFC边框窗口实现了菜单命令消息的处理和菜单项状态的更新。
CFrameWnd提供了OnBarCheck来响应与ID_VIEW_STATUS_BAR、ID_VIEW_TOOLBAR菜单项对应的命令。
消息映射：
ON_COMMAND_EX(ID_VIEW_STATUS_BAR, OnBarCheck)
ON_COMMAND_EX(ID_VIEW_TOOLBAR, OnBarCheck)
这里，使用了扩展命令消息映射宏把ID_VIEW_STATUS_BAR和ID_VIEW_TOOLBAR命令映射给同一个函数OnBarCheck处理。
OnBarCheck函数的实现：
BOOL CFrameWnd::OnBarCheck(UINT nID)
{
ASSERT(ID_VIEW_STATUS_BAR == AFX_IDW_STATUS_BAR);
ASSERT(ID_VIEW_TOOLBAR == AFX_IDW_TOOLBAR);

//得到工具条或者状态条
CControlBar* pBar = GetControlBar(nID);
if (pBar != NULL)
{
<DIR>
//若控制条可见，则隐藏它；否则，显示它
ShowControlBar(pBar, (pBar->GetStyle() & WS_VISIBLE) == 0, FALSE);
//处理完毕
return TRUE;</DIR>
}
//可以让下一个命令目标继续处理
return FALSE;
}
由于是扩展映射宏定义的消息处理函数，所以OnBarCheck函数有一个UINT类型的参数和一个BOOL返回值。
当用户从“View”菜单选择打了钩的“Toolbar”时，消息处理函数OnBarCheck被调用，参数就是菜单项的ID号ID_VIEW_TOOLBAR，它等于工具条的子窗口IDAFX_IDW_TOOLBAR。处理结果，工具条被隐藏；当再次选择该菜单项则工具条被显示。
处理状态条的过程类似于工具条的处理。
ShowControlBar是CFrameWnd的成员函数，参数1表示控制条对象指针，参数2表示显示(TRUE)或者隐藏(FALSE)，参数3表示是立即显示（FALSE）或者延迟显示（TRUE）。

如果工具条或者状态条被隐藏，则相应的菜单项ID_VIEW_STATUS_BAR 或者ID_VIEW_TOOLBAR 变成uncheked（菜单项被标记为没有选择），否则，checked（菜单项被标记选择）。CFrameWnd实现了这两个菜单项的状态更新处理，列举其中一个如下：
声明处理ID_VIEW_TOOLBAR的状态更新消息：
ON_UPDATE_COMMAND_UI(ID_VIEW_TOOLBAR, OnUpdateControlBarMenu)
函数的实现：
void CFrameWnd::OnUpdateControlBarMenu(CCmdUI* pCmdUI)
{
ASSERT(ID_VIEW_STATUS_BAR == 
AFX_IDW_STATUS_BAR);
ASSERT(ID_VIEW_TOOLBAR == AFX_IDW_TOOLBAR);

CControlBar* pBar = GetControlBar(pCmdUI->m_nID);
//存在工具栏
if (pBar != NULL)
{
//工具条窗口被显示则checked，被隐藏则uncheked
<DIR>
pCmdUI->SetCheck((pBar->GetStyle() & WS_VISIBLE) != 0);
return;</DIR>
}
pCmdUI->ContinueRouting();
}
GetControlBar是CFrameWnd的成员函数，用来返回边框窗口的指定ID的控制条对象（指定ID是控制条的子窗口ID）。
<OL>
<OL>
<OL>

<LI>泊位和漂浮
</LI></OL></OL></OL>
工具条可以泊位在边框窗口的任一边(上、下、左、右)，或者漂浮在屏幕上的任何地方。
<OL>

<LI>实现泊位的方法

首先，边框窗口调用CFrameWnd::EnableDocking函数使控制条泊位在边框窗口中有效，指明在边框窗口的哪边接受泊位。如果想在任何边都可以泊位，则使用参数CBRS_ALIGN_ANY。
然后，工具条调用ControlBar::EnableDocking使泊位对工具条有效，如果在调用ControlBar::EnableDocking时指定的泊位目的边和边框窗口能够泊位的边不符合，那么工具条不能泊位，它将漂浮。
最后，边框窗口调用CFrameWnd:

ockControlBar泊位工具条。

<LI>泊位后形成窗口层次关系

边框窗口、泊位条、工具条的包含关系如下：
边框窗口
泊位条1
工具条1
工具条2
…
泊位条2
…
边框窗口包含1到4个泊位条子窗口，每个泊位条包含若干个控制条子窗口。

<LI>泊位的实现

CFrameWnd::EnableDocking指定哪边接受泊位，则为泊位准备一个泊位条。泊位条用CDockBar描述，派生于CControlBar。如果指定任何边都可以泊位，则创建四个CDockBar对象和对应的HWND窗口。然后，调用ControlBar::EnableDocking在对应的泊位条内安置工具条。
MFC设计了CDockBar类和CFrameWnd的一些函数来实现泊位，具体代码实现在此不作详细讨论。

<LI>实现漂浮工具条的方法：

边框窗口调用FloatControlBar实现工具条的漂浮。

<LI>漂浮的实现：
</LI></OL>
首先，创建一个微型漂浮边框窗口，该边框窗口有一个泊位条。
然后，在微型边框窗口的泊位条内放置工具条。
MFC设计了微型边框类CMiniFrameWnd，在此基础上派生出微型泊位边框窗口类CMiniDockFrameWnd。CMiniDockFrameWnd增加了一个CDockBar类型成员变量m_wndDockBar，即泊位条。
在CMiniDockFrameWnd对象被创建时，创建泊位条m_wndDockBar。泊位条m_wndDockBar的父窗口如同CMiniDockFrameWnd的父窗口一样，是调用FloatControlBar的边框窗口，而不是微型泊位边框窗口。微型边框窗口和泊位条创建完成之后，调用ControlBar:

ockControlBar泊位工具条在CMiniDockFrameWnd窗口。
具体的代码实现略。
SOCKET类的设计和实现 

<OL>

<LI>WinSock基本知识

这里不打算系统地介绍socket或者WinSock的知识。首先介绍WinSock API函数，讲解阻塞/非阻塞的概念；然后介绍socket的使用。
<OL>

<LI>WinSock API

Socket接口是网络编程（通常是TCP/IP协议，也可以是其他协议）的API。最早的Socket接口是Berkeley接口，在Unxi操作系统中实现。WinSock也是一个基于Socket模型的API，在Microsoft Windows操作系统类中使用。它在Berkeley接口函数的基础之上，还增加了基于消息驱动机制的Windows扩展函数。Winscok1.1只支持TCP/IP网络，WinSock2.0增加了对更多协议的支持。这里，讨论TCP/IP网络上的API。
Socket接口包括三类函数：
第一类是WinSock API包含的Berkeley socket函数。这类函数分两部分。第一部分是用于网络I/O的函数，如
accept、Closesocket、connect、recv、recvfrom、Select、Send、Sendto
另一部分是不涉及网络I/O、在本地端完成的函数，如
bind、getpeername、getsockname、getsocketopt、htonl、htons、inet_addr、inet_nton
ioctlsocket、listen、ntohl、ntohs、setsocketopt、shutdow、socket等
第二类是检索有关域名、通信服务和协议等Internet信息的数据库函数，如
gethostbyaddr、gethostbyname、gethostname、getprotolbyname
getprotolbynumber、getserverbyname、getservbyport。
第三类是Berkekley socket例程的Windows专用的扩展函数，如gethostbyname对应的WSAAsynGetHostByName（其他数据库函数除了gethostname都有异步版本），select对应的WSAAsynSelect，判断是否阻塞的函数WSAIsBlocking，得到上一次Windsock API错误信息的WSAGetLastError，等等。
从另外一个角度，这些函数又可以分为两类，一是阻塞函数，一是非阻塞函数。所谓阻塞函数，是指其完成指定的任务之前不允许程序调用另一个函数，在Windows下还会阻塞本线程消息的发送。所谓非阻塞函数，是指操作启动之后，如果可以立即得到结果就返回结果，否则返回表示结果需要等待的错误信息，不等待任务完成函数就返回。
首先，异步函数是非阻塞函数；
其次，获取远地信息的数据库函数是阻塞函数（因此，WinSock提供了其异步版本）；
在Berkeley socket函数部分中，不涉及网络I/O、本地端工作的函数是非阻塞函数；
在Berkeley socket函数部分中，网络I/O的函数是可阻塞函数，也就是它们可以阻塞执行，也可以不阻塞执行。这些函数都使用了一个socket，如果它们使用的socket是阻塞的，则这些函数是阻塞函数；如果它们使用的socket是非阻塞的，则这些函数是非阻塞函数。
创建一个socket时，可以指定它是否阻塞。在缺省情况下，Berkerley的Socket函数和WinSock都创建“阻塞”的socket。阻塞socket通过使用select函数或者WSAAsynSelect函数在指定操作下变成非阻塞的。WSAAsyncSelect函数原型如下。
int WSAAsyncSelect( 
SOCKET s, 
HWND hWnd, 
u_int wMsg, 
long lEvent 
);
其中，参数1指定了要操作的socket句柄；参数2指定了一个窗口句柄；参数3指定了一个消息，参数4指定了网络事件，可以是多个事件的组合，如：
FD_READ 准备读
FD_WRITE 准备写
FD_OOB 带外数据到达
FD_ACCEPT 收到连接
FD_CONNECT 完成连接
FD_CLOSE 关闭socket。
用OR操作组合这些事件值，如FD_READ|FD_WRITE
WSAAsyncSelect函数表示对socket s监测lEvent指定的网络事件，如果有事件发生，则给窗口hWnd发送消息wMsg。
假定应用程序的一个socket s指定了监测FD_READ事件，则在FD_READ事件上变成非阻塞的。当read函数被调用时，不管是否读到数据都马上返回，如果返回一个错误信息表示还在等待，则在等待的数据到达后，消息wMsg发送给窗口hWnd，应用程序处理该消息读取网络数据。
对于异步函数的调用，以类似的过程最终得到结果数据。以gethostbyname的异步版本的使用为例进行说明。该函数原型如下：
HANDLE WSAAsyncGetHostByName( 
HWND hWnd, 
u_int wMsg, 
const char FAR *name, 
char FAR *buf, 
int buflen 
);
在调用WSAAsyncGetHostByName启动操作时，不仅指定主机名字name，还指定了一个窗口句柄hWnd，一个消息ID wMsg，一个缓冲区及其长度。如果不能立即得到主机地址，则返回一个错误信息表示还在等待。当要的数据到达时，WinSock DLL给窗口hWnd发送消息wMsg告知得到了主机地址，窗口过程从指定的缓冲区buf得到主机地址。
使用异步函数或者非阻塞的socket，主要是为了不阻塞本线程的执行。在多进程或者多线程的情况下，可以使用两个线程通过同步手段来完成异步函数或者非阻塞函数的功能。
</LI></OL></LI></OL>

帐号		自动登录	找回密码
密码			立即注册