第三部分编程帮助工具

第 6 章 C lass W izard （类向导）

用 AppWizard 创建一个项目之后，你便拥有了 ClassWizard 这个 Visual C++ “ 程序员助手 ” 选项。从广义上讲， ClassWizard 与类的关系和 AppWizard 与应用程序的关系是相同的。 ClassWizard 通过生成实现 CPP 文件，以及一个带有合适存根函数的头文件，来帮助你开始编写新类。用实际的代码填充这些函数则是你的责任。

ClassWizard 在四个区域提供帮助，它可以为如下目的生成代码：

从接收消息或管理控件窗口的许多 MFC 类中的一个派

生出来的新类。
处理消息的成员函数。
OLE/ActiveX 方法、属性和事件触发。
用于输入到对话控件中的数据交换和验证函数。

ClassWizard 识别和支持 MFC 基类，它们用某种方法与用户进行交互。除了少数例外的类（例如 CRecordSet 和 CHttpServer）之外，基类都是由 CCmdTarget 派

生而来，它们能够对消息作出反应，并能够管理对话框中的控件。大约有 50 个多个 MFC 基类，你可以使用 ClassWizard 从这样的类中创建一个派生类；参考本书附录 B ，可以得到一个完整列表。

访问 ClassWizard

不能从一个空的项目中访问 ClassWizard 。项目中至少应有一个 RC 文件，即使这个 RC 文件是空的。一旦 RC 文件被附加到项目之中（ AppWizard 可以自动完成这项工作），你就可以通过从 View 菜单中选择 ClassWizard 命令来调用ClassWizard 对话了，如图 6-1 所示。

第三部分编程帮助工具 - 图1

图 6-1 View 菜单中的 ClassWizard

关于 ClassWizard ，有两点不大明显。首先，它的服务完全是可选的。你在开发自己项目的过程中，如果自己愿意的话，从头至尾，都可以不处理 ClassWizard 。其次，你可以使用 ClassWizard 向 MFC 项目添加新类，即使该项目不是由AppWizard 创建的。 ClassWizard 编译项目的类的数据库，并将它存储在与项目同名且扩展名为 CLW 的一个文件之中。如果你一直都是使用 ClassWizard 为项目创建新类，那么 CLW 文件可以保持最新。不过，在 Visual C++ 中，你与ClassWizard 之间并不是全有或全无的关系，你可以自由地编写新类，或者从当前项目之外的其他源文件中复制代码。在一个类不是以 ClassWizard 为起源的情况下，有一个简单的方法可以更新 CLW 数据库。在你使用了 Project 菜单上的Add To Project 命令向项目添加新类源文件之后，请删除 CLW 文件，并再次调用

ClassWizard 。 Visual C++ 将检测到数据库不存在了，并提供重新创建它的服务：

第三部分编程帮助工具 - 图2

当你单击 Yes 接受创建新数据库的服务之后，将出现一个标题为 Select Source Files 的对话，其中带有一个 Visual C++ 创建类数据库将要读取的实现文件和文件夹列表。如果你已经将全部的新源文件都插入到了项目之中，那么列表应该已经是完整的了，因此除单击 O K 外，你不需要做任何事情。进程指示器主要用来指示 Visual C++ 正在创建数据库文件，在此之后，将出现 ClassWizard 对话框。

ClassWizard 对话

图 6-2 显示了主 ClassWizard 对话框。我之所以叫它为 “ 主 ” 对话，是因为

ClassWizard 可以在 20 多种不同的对话中显示自己，究竟在哪一个对话中显示需

取决于环境。图 6-2 中的对话充当着到 ClassWizard 主入口的角色，将其命名为MFC ClassWizard ，以便于让你记住它所处理的仅仅是 MFC 类。 ClassWizard 不能帮助你创建从除了支持 MFC 类之外的任何类中派生的类；对于带有任何其他基的类，你必须使用文本编辑器或 Insert 菜单上的 New Class 命令从零开始自己编写代码。在本章稍后将详细介绍 New Class 命令。

第三部分编程帮助工具 - 图3

图 6-2 MFC ClassWizard 对话

MFC ClassWizard 对话的五个选项卡具有不同的用途，对于任何一个特定的类，都不是完全需要这五个选项卡。表 6-1 可以帮助你确定自己需要哪个（或哪几个）选项卡，这主要取决于你想为自己的类做哪些工作。

表 6-1 MFC C lass W izard 对话框的五个选项卡选项卡用途

M essage Map s（消息映射）

M ember Variables （成员变量）

添加或删除处理消息的成员函数

添加或删除附加到使用控件的类上的成员变量。一般地说，这些是从 CDialog ， CPropertyPage ， CRecordView 或CDaoRecordView 中派生的对话类

Automation 向支持 Automation 的类（例如 ActiveX 控

件类）添加属性或方法

续表

ActiveX Events 为触发事件（通常是实现 ActiveX 控件的

类）添加支持。在开发接收触发事件的容器应用程序时，不用该选项卡

Class Info 有关项目的类的其他信息

在 ClassWizard 对话中，标为 M essage Maps 和 Member Variables 的头两个选项卡将在下两节介绍。Automation 和 ActiveX Event 选项卡的讨论推迟到第 8 章和第 9 章，这两章将阐述 ClassWizard 如何在包含 ActiveX 控件的项目开发中起帮助作用。

Message Maps （消息映射）选项卡

M essage Map s（消息映射）选项卡是你为自己的类指定消息处理函数的地方。该选项卡中的两个组合框和前两个列表框是这样安排的 , 每个控件都显示逐渐高一级的控件详细资料。换句话说，控件的内容取决于前面控件中的选中部分。Class Nam e（类名）组合框列出了 Project 组合框中选中的项目的类； Object IDs 框中显示的是与 Class Name 框中选中的类相关联的标识符， M essage 框中显示的是Object IDs 框中当前选中部分的消息和其他信息。表 6-2 显示了 Object IDs 框中

选中的项目和 M essage 框内容之间的关系。

表 6-2 在 Message Map 选项卡中， Object Ids 框中的选中部分决定了 Message

框的内容

Object IDS 框中选中部分

Message 框的内容

类名 W M _ 消息和处理消息的类虚拟函数

菜单命令标识符用于菜单命令消息的 ON_COMMAD 和

ON_COMMAND_UI 宏

控件标识符控件通知消息。反应的消息用等于（ = ）前缀

标记

当你在 M essage 框中选中一条消息或虚拟函数的时候，将在 MFC ClassWizard 对话的底部出现选中项目的简要说明。如果想了解有关选中项目的详细信息，可以像第一章中介绍的那样切换到 M S D N 在线帮助，然后再搜索索引。与 Visual C++ 旧版本不同，按下 F1 键将显示有关 M essage 框本身的一般信息，而不是有关选中项目的信息。

如果想向选定的类添加消息处理程序函数，请双击 Message 框中的消息或虚拟函

数。Member Functions 框包含有当前类函数的一个列表，在图 6-2 中是 InitInstance 和 OnAppAbou t 。“ W ” 标识符将 OnAppAbout 作为一个处理带有 W M _ 前缀的系统消息的函数来标识，在本例中，是包含有 ID_APP_ABOUT 菜单值的W M _ C O M M A N D 。“ V ” 用来将 InitInstance 作为一个超越虚拟函数来标识。

对于添加到类的每个消息处理程序函数， ClassWizard 对该类的源文件做三处修改：

向头文件添向函数声明。
向 CPP 实现文件添加带有骨干代码的函数定义。
将代表该函数的条目添加到类的消息映射。

Member Variables （成员变量）选项卡

M ember Variables（成员变量）选项卡与使用控件的类相关，这些类中的大部分是从 CDialog ， CPropertyPage， CFormView ， CRecordView 或 CDaoRecordView 中派生出来的。从上述五个 MFC 类中的一个派生出来的类叫做对话类，因为它需要一个代表对话资源的标识符。 Member Variable s（成员变量）选项卡是指定从类对话中的控件中接收数据的成员变量的地方。

如果想向对话类添加成员变量，请打开 M ember Variables （成员变量）选项卡，并从 Class Nam e（类名）框中选择类。在 Control IDs 框中，选择你想向其上附加新变量的控件的标识符，然后单击 Add Variable 按钮打开如图 6-3 所示的 Add M ember Variable 对话。

第三部分编程帮助工具 - 图4

图 6-3 从 Member Variables（成员变量）选项卡中调用的 Add Member Variable 对话框

在可选的“ M ” 前缀后面键入变量名，然后根据控件类型，在 Category 框中选择Value 或 Control。 Value 设置的意思是指该变量包含有这个控件的数据，例如用户向编辑框键入的文字或数字值。 Control 设置的意思是该变量代表控件本身。作为一个例子，可以把成员变量考虑成一个复选框控件。选定 Value 类别可以使该成员变量成为 Boolean 型，能够包含有用来指示该复选框状态的值 TRUE 或FALSE 。然而，选择 Control 类别，将使变量成为一个代表复选框控件的 CButton 对象。如果你想使用该变量来确定用户是打开还是关闭了这个复选框，那么请选择 Value 类别。如果你想使用该变量在运行时以某种方式改变复选框，例如通过调用 CButton:SetWindowText 来改变标题，或通过调用 CButton::SetCheck 设置复选框的状态，那么请选择 Control 类别。

表 6-3 列出了可用的标准控件的变量类型。当你阅读该表时，请记住如下几点：

编辑框特别适合将数据传递给许多不同类型的变量。

表中提到的 “ 数字 ”数据类型是一个包罗万象的术语，它包括 BYTE ，short ，int ，UNIT ， long， DWORD ， float 和 double 。
ClassWizard 不列出由 IDC_STATIC 值标识的静态控件。如果

想把静态控件与变量关联起来，应首先为该控件分配一个除了 IDC_STATIC 之外的值。
在一组单选按钮中，仅有该组中第一个按钮的标识符

出现在 Control ID s 框中。当我们稍后讨论与小组的第一个按钮相关联的单个变量是

如何代表整个小组的时候，你就会清楚为什么不包括小组中其他按钮的原因。

正如表中所指示的， Push 按钮控件不允许 Value 类别的
变量，因为这些控件不接受来自用户的数据。

表 6-3 用于标准控件的 Value 和 Control 类别的变量类型

数

据类型

控件			Value 类别		Control 类别
复选框			BOOL		CButton
复选框态）	（	三	Int		CButton
组合框			CString 或	int	CComboxBox

编辑框 CString, BOOL ，数字，

续表

CEdit

	COleDateTime
列表框	COLeCurrency Cstring 或 int	CListBox
压入式按钮		CButton
单选按钮	Int	CButton
滚动条静态文本	int CString	CScrollBar CStatic

通过使用 ClassWizard 向对话类添加成员变量，你可以利用 ClassWizard 所提供的高效特征：为对话数据交换和对话数据验证自动生成源代码，也就是人们所熟知的 DDX/DDV 。数据交换和验证仅仅应用于为之选定了 Value 类别的成员变量。也就是说，具有在表 6-3 中间那列列出的类型的成员变量。

对话数据交换负责数据在控件中的进出。当对话首次出现的时候，每个控件窗口自动用相应的成员变量的值进行初始化。当用户通过单击 O K 按钮，或通过按

Enter 键关闭对话的时候，该控件无论是包含哪一个值或文本，都将被复制回该变量。对话数据验证可以确保值落在规定的限制之内。交换和验证机制都是由MFC 框架通过表 6-4 和 6-5 中所列出的函数集提供的。每个函数都有一个前缀D D X _ 或 D D V _ ，来把它作为数据交换或数据验证函数来标识。

表 6-4 常见的对话数据交换函数

交换函数获得 / 设置这种类型的数据 …

… 用于该种类型控件

DDX_CBIndex int Combo box

DDX_CBString CString Combo box

DDX_CBStringExa ct

CString Combo box

DDX_Check int Check box

DDX_DateTimeCtrl Ctime Date-time picker

DDX_LBIndex int List box

续表

DDX_LBString CString List box

DDX_LBStringExa ct

CString List box

DDX_MonthCalCtrl Ctime Month calendar

DDX_Radio int Radio button

DDX_Scroll int Scroll bar

DDX_Text CString or numerical (BYTE,

short,int,UINT,long,etc.)

Edit control

对话数据交换（ DDX ）

MFC 提供了大量的对话数据交换函数，它们可以在对话类中的控件成员变量之间移动数据。除了表 6-4 中所列的常见函数之外，还有用于记录集数据和由ActiveX 控件返回的数据的特殊交换函数。 DDX_Control 函数可以为几种不同类型的控件传输数据，例如 Animate 和 IP Address。如果想了解有关数据交换函数

的更为详细的信息，请参考 Visual C++ 在线帮助。

表 6-4 中列出的 DDX_Radio 函数值得讨论一下。在所有的数据交换函数之中，该函数是独一无二的，它只应用于一组控件，而不是一个控件。 DDX_Radio 返回一个 int 值用来指示用户打开了组中的哪个按钮： 0 代表组中的第一个按钮， 1 代表第二个按钮，以此类推。值 -1 的意思是小组中的所有按钮都是清除的。你可以调用 DDX_Radio 来确定单个单选按钮的状态（假如它是组中的唯一一个按钮）。在这种情况下，返回值 0 的意思是按钮是打开的，值 -1 意为按钮是关闭的。建立一个单选按钮通常在对话编辑器中进行，我们一会儿就能看到。

对话数据验证（ DDV ）

表 6-5 列出了八个对话数据验证函数，它们仅仅应用于接受用于从键盘输入数据的控件成员变量。换言之，就是编辑控件和组合框。

表	对话数据交换函数
验证函数	验证 …
DDV_MinMaxByte	指定限制范围内的一个	BYTE 值
DDV_MinMaxInt	指定限制范围内的一个	int 值
DDV_MinMaxUInt	指定限制范围内的一个	UNIT 值
DDV_MinMaxLong	指定限制范围内的一个	long 值
DDV_MinMaxDWord DDV_MinMaxFloat	指定限制范围内的一个指定限制范围内的一个	DWORD 值 float 值
DDV_MinMaxDouble	指定限制范围内的一个	double 值

DDV_MaxChars CString 字符串的长度不能超过指定的最大长度

当你为编辑控件或组合框添加成员变量，然后在 M ember Variable 选项卡中的

Control IDs 框中选择控件的时候，两个提示之一将会出现在该选项卡的底部。究

竟出现哪一个提示取决于变量所具有的是数字数据，还是文字数据；在任一种情况下，都要输入用于验证的变量限制值：

第三部分编程帮助工具 - 图5

除了一个对话数据验证函数之外，所有函数都监视数值数据，以确保由用户输入的值落在指定的上下限之间。例外是 DDV_MaxChars 函数，它用来验证键入到编辑控件或组合框中的字符数不超过给定的最大值。与表 6-4 中列出的交换函数不同，验证函数仅仅在对话关闭的时候起作用，而不在它刚出现的时候起作用。如果输入到一个控件的值落到了指定的限制之外，那么，该控件的验证函数将显示一个消息框，以通知用户出了问题。当消息框被关闭的时候，出问题的控件将具有一个焦点，提示用户重新输入数据。除非所有的数据验证函数都满足了，否则，用户不能够通过单击 O K 来关闭对话。

DoDataExchange 函数

ClassWizard 把叫做 DoDataExchange 的成员函数添加到对话类的 CPP 文件。这个

函数包含对话所需要的对数据交换和验证函数的所有调用。例如，对于接受从 1

到 99 的整数的单个编辑控件，ClassWizard 可以编写不同的 DoDataExchange 函数：

void CDemoDlg::DoDataExchange(CDataExchange* pDX)

{

CDialog::DoDataExchange(pDX);

//{{AFX_DATA_MAP(CDemoDlg) DDX_MinMaxInt(pDX,m_nEditVal, 1, 99);

//}}AFX_DATA_MAP

}

DoDataExchange 是一个完整的函数，并不是你必须进一步添加的存根代码。既然在对话开始和结束的时候，框架都要调用 DoDataExchange ，那么，有时向它添加初始化和清除代码是很方便的，否则你通常会忘记该函数的存在。如果你在M ember Variable s（成员变量）选项卡删除了一个变量，那么 ClassWizard 将会在DoDataExchange 函数中删除对该变量任何数据的交换和验证调用。

ClassWizard 和 AppWizard 为项目中的每个对话编写 DoDataExchange 函数，即使

对话没有接受用户输入的控件也是如此。例如，由 AppWizard 生成的 About 框类具有一个 DoDataExchange 函数，即使该对话没有任何控件（一个图标，两行静态文字和一个压入式按钮）可以从用户处接收数据。如果你想让一个控件仅仅显示数据，而不允许用户改变值，那么应该删除 ClassWizard 添加到 DoDataExchange 的控件的任何 DDX/DDV 调用。另一个选项是完全删除 DoDataExchange 函数，我们将要在本章稍后看到另一个例子。

在创建对话的时候，在设计过程的早期，你应该考虑一下对话的类是如何在对话数据交换与验证融合在一起的。在第 5 章中介绍过，对话编辑器允许你通过在控件的 Properties 框中打开或关闭合适的复选框来设计每个控件的属性。当为使用对话数据交换和验证的控件设计属性的时候，请记住以下几点：

对于只接受简单的十进制（而不是十六进制）的整数
的编辑控件，在

Edit Propertie s（编辑属性）对话的 Style s（风格）选项卡中设置 Number

（数字）复选框。这将给这个控件分配一个样式标志 ES_NUMBER ，使它忽略除从 0 到 9 之外的任何字符，其中也包括逗号和句号。

如果组合框或列表框只接受自由数字数据，那么，请
访问该控件的Properties 对话，并关闭它的排序选项。对于组合框和一般的列表框，请清除 Styles （风格）选项卡中的 Sort Property （排序属性）复选框；对于列表控件，确保 Styl e（风格）选项卡中的 Sort Selectio n（排序选择）为 None 。因为这些控件将根据数字的 ASCII 值，而不是数字值，

对数字进行排序，仅仅当条目具有固定的数字号码，并且包含有前导

0 （例如 001 和 099 ）时，它们才能正确地排出一个号码列表。

当你创建一组单选按钮的时候，请为组中的每个按钮

设置 Auto 属性。这将使得这个单选按钮成为互斥的，以便单击一个按钮将自动清除组中其他所有的按钮。
仅仅为组中的第一个单选按钮设置 Group 属性，确保组

中其他所有的按钮按照 Tab 键顺序跟在第一个按钮之后。如果这样做失败了，那么当用户按箭头键时，将禁止对话将焦点从一个单选按钮移动到下一个单选按钮。另外，还要为紧跟在组中最后的单选按钮之后的那个控件设置 Group 属性。这表示这是前一组的末尾和另一组的开始。在调试器中运行该程序将会告诉你，何时一组单选按钮不能由 Group 属性来正确地定界，因为当对话出现的时候，调试器将在 Output 窗口中显示这条消息。

Warning: skipping non-radio button in group .（警告：跳过组中的非单选按钮）

向项目添加类

MFC ClassWizard 的所有五个选项卡都具有 Add Clas s（添加类）按钮，因为你可以从对话的任何一个选项卡中开始一个新类。单击了 Add Class （添加类）按钮

之后，选中如下两个选项之一：

Ne w（新建）：创造包含有由 ClassWizard 生成的骨干代码

的 CPP 文件和 H 文件。
From a type library （来自类型库）：为基于 OLE 类库的一

个类创建源代码。这个类型库可以是一个单独的文件（通常具有 TLB 扩展名），或者它可以作为资源数据包含在像动态链接库这样的程序内部。动态链接库一般具有如下扩展名： OLB （对象库）、 OCX （ ActiveX 控件）或 DLL 。例如，选择第 8 章中介绍的任何一个 ActiveX 控件，都将从OCX 文件的类型库信息中生成的项目中添加类源代码。在你定位并选中了所需要的类型库文件之后，在类列表中选择一个类，这个类列表是 ClassWizard 从库中的信息收集保存的，并在 Confirm Classes( 确认 ) 对话中显示。如果你希望为当前的项目重命名选中的类，那么请在Class Name 控件中输入新的名字。你还可以指定 ClassWizard 所创建的 CPP 和 H 文件的名字。

两个选项都可以为新类自动更新 CLW 数据库。如果想通过从另一个项目中复制一个现有的类来创建一个新类，那么可以采用三种不同的方法。借用现有类的最直接方法是将源代码复制到你的项目文件夹，并使用 Add To Project（添加到项目中）命令，将 CPP 文件添加到项目。在弹出式次级菜单中单击 File s，然后双击文件列表中该类的 CPP 文件。正如前一章中所提及的，不必要以相同的方法

添加头文件，原因是 Visual C++ 是将头文件做为从属文件来识别。第二种方法需要从 Project 菜单中 Insert Project Into Workspace （插入项目到工作空间）命令来插入现有的项目。然后，你就可以自由地从插入的项目中借用源文件了。第三种方法是通过 Gallery ，我们将在第 7 章中进行讨论。

你可能不是从类型库中添加一个现有的类，而是更经常地选择 New 选项，来让ClassWizard 启动你想开发的新的派生类。单击 New 将显示如图 6-4 所示的 New Class 对话框，在这个对话框中，你可以为你的类输入一个名字，然后从ClassWizard 支持的 MFC 类中选择它的基。

第三部分编程帮助工具 - 图6

图 6-4 从 ClassWizard 中调用的 New Class 对话

为了命名类源文件， ClassWizard 向你所指定的类名添加 CPP 和 H 文件扩展，去掉任何 C 前缀，如果你想采用其他名称，请单击 Change 按钮。

D ialog ID 控件是否在 New Class 对话中处于活动状态取决于所选中的基类。当你作为基类从五个 MFC 对话类（ CDialog ，CProperty Page ，CFormView ，CRecordView 或 CDaoRecordView ）中进行选择的时候， Dialog ID 控件处于激活状态，提示与新类相关联的对话的资源标识符。创建基于对话的类的最好方法是，首先在对话编辑器中设计和保存对话资源，然后，在编辑器仍然处于激活状态且有输入焦点的时候，访问 ClassWizard ，来为对话创建新类。在本章稍后的例子中，我们将这样做。

Automation 组框中单选按钮的外观取决于选中的基类是否支持 Automation 。当你选中像 CHttpFilter 这样的基类的时候，将出现一条十分详细的消息，通知你Automation 不是一个选项。不过，对于可察知 Automation 的基类， Automation 单选按钮是启用的。打开该按钮，将指导 ClassWizard 编写代码来生成源文件，从而使得这个新类成为一个可编程的对象，而且对于像 M icrosoft Excel 这样的Automation 客户应用程序来说是可见的。本书附录 B 标识了那些 MFC 类可察知Automation 。如果你想了解有关 Automation 的更多信息，由 David Kruglinski 编著的 Inside Visual C++ 中，专门有一章来讨论这一主题。

单击 Createable By Type ID（通过类型 ID 可创建）单选按钮将生成代码，这些代码允许其他的 ActiveX 应用程序创建你的新类的 Automation 对象。 ClassWizard

自动将项目名和类名组合起来，以形成编辑控件中所显示的类型标识符，以及一个用来帮助确保标识符为独一无二的方案。这个类型标识符也就是大家所熟知的程序设计标识符，它可以被 ActiveX 客户应用程序用来指定对象。例如，一个Excel 宏可以创建一个 CNewClass 对象：

Set DemoObj=CreatObject ("Demo.NewClass")

添加非 MFC 类

ClassWizard 对话不是向项目添加类的唯一方法。单击 Insert 菜单上的 New Class 命令，将显示如图 6-5 所示的对话，它与图 6-4 中的对话共享相同的名字，而且看起来十分相似。唯一的不同是，在对话的顶部多了个 Class Type 框，它是用来指示 New Class 命令的双重特性的。

对于类的类型，默认选择是 MFC Class ，这将导致对话的行为与图 6-4 中的 New Class 对话一致。选择 Base Class 控件中的一个基本 MFC 类，并且像以前一样设置 Automation 单选按钮。如果想创建一个基于表单的新类，请在 Class Type 框中选择 Form Class ，然后选择 CFormView ， CDialog ， CRecordView 或CDaoRecordView 的一个基类。对于类的类型，第三个方案是 Generic Class ，它将导致 Visual C++ 为不是从 MFC 中派生的类生成存根代码。Visual C++ 仅仅借用来自 ClassWizard 的技术，如果你愿意看到 New Class 命令只是作为 ClassWizard 中的另一部分，当然也可以。但是一定要切记，图 6-4 所示的 New Class 对话的变种仅仅可用于从 MFC 派生而来的类，对于它，你总是可以应用 ClassWizard

的全部功能。用 New Class 命令创建常规的非 MFC 的类将生成存根代码，但同时也舍弃了 ClassWizard 的其他功能。

第三部分编程帮助工具 - 图7

图 6-5 通过从 Insert 菜单 New Class 命令进行访问的 New Class 对话

对话中的 Generic Class 设置启用一个列表框，你可以从中为新类选择一个基。生成的源代码仅仅由用于类构造器和析构器的存根函数组成，这些函数包含在一个为该类命名的 CPP 文件和 H 文件之中。例如，这是 New Class 命令为从 CBaseClass 中派生出来的类写到头文件中的声明。

class CDerivedClass : public CBaseClass

{

public:

CDerivedClass();

virtual ~CDerivedClass();

};

除了 New Class 命令之外， Visual C++ 还提供了 ClassWizard 的其他分支。我们将要在下面看到，WizardBar 作为到达 ClassWizard 的侧门，它通常比主要入口更加方便。

W izardBa r（向导栏）

W izardBar 是一个可停靠的工具栏，当你在文本和对话编辑器中四处移动的时候，它可以记住插字符的位置或当前选中的部分。无论你当前正在处理的是哪一类，该栏都会连续不断地调整它的外观。例如，打开用于 CMainFrame 类的实现文件将自动为该类初始化 W izardBar，提供一种方便的方法迅速找到成员函数的定义和声明。和其他任何 Visual C++ 工具栏一样，你可以通过单击 Tools 菜单上的 Customize 命令，并在 ToolsBar 选项中选中合适的复选框来将 W izardBar 打开或关闭。

图 6-6 显示了 W izardBar 的类型视图。

第三部分编程帮助工具 - 图8

图 6-6 WizardBar

W izardBar 的三个组合框用于封装在 MFC ClassWizard 对话的 M essage Map s（消息映射）选项卡中显示的信息，ClassWizard 中所做的任何改变都可以在 W izardBar 中连续不断地反映出来。表 6-6 说明了 W izardBar 的框和按钮。

W izardBar 最右边的箭头按钮显示的是图 6-7 中所示的选项的下拉菜单。

表 6-6 W izardBar 上的控件

向导控件说明

Classes（类）显示编辑器中当前处于打开状态的类名，并且

提供一个项目中所有类的下拉列表。当既没有文本编辑器也没有对话编辑器具有焦点的时候，框中条目是灰色的

Identifiers （标识符）

列出当前所使用的符号标识符 ( 当前类的名字出现在 W izardBar 的 Classes 框中 )

Function s（函数）包含用于当前类的虚拟函数和 CCmdTarget 的

过程名

续表

Default （默认）单击位于 W izardBar 最右端的 “ 棍棒 ” 图标，

将执行两行 W izardBar 菜单的默认命令。默认命令取决于当前的支持以及在 W izardBar 中选中的部分。例如，如果类实现文件在文本编辑器中处于打开状态，并且插字符在函数块之内，那么默认的操作将是 Go To Function Declaration（转向函数声明），即打开类的头文件，并定位在函数原型中的插字符位置，然后，默认的操作将变为 Go To Function Definition

（转向函数定义），将插字符发回到实现 CPP 文件，默认操作总是在 WizardBar 菜单上列出的第一个命令，如图 6-7 所示

M enu （菜单）显示可用选项的 W izardBar 菜单，将在下面列

出的项目符号列表中仔细说明

菜单的内容反映了当前处于活动状态的文档，因此，当源文档在文本编辑器中处于打开状态的时候，像 Go To Next Function 这样的命令才可用。在菜单命令的以下说明中，词“ 当前 ” 指的是 W izardBar 中的设置。例如，当前类是在 W izardBar 的 Classes 框中显示的类，如图 6-6 所示。

第三部分编程帮助工具 - 图9

图 6-7 通过单击 WizardBar 上的箭头按钮显示的 WizardBar 菜单

Go To Function Definition （转向定义）：如果必要的话，

打开源 CPP 文件，并在当前函数的第一行放置插字符，在 W izardBar 的 Functions 框中标识。
Go To Function Declaration （转向函数声明）：在当前函数

的原型处放置插字符。
Add Windows Message Handler（添加窗口消息处理函数）：调

用 New Windows Message Handle r（新建窗口消息处理程序）对话。在该对话中，可以快速从 CWnd 开始，向随后的类中添加存根消息处理程序函数。
Add Virtual Function（添加虚拟函数）：超越基类的虚拟

函数。该命令显示两个列表，一个包含有可以为超越提供的虚拟函数，另外一个显示已被当前类超越的那些函数。这些列表提供了与 MFC ClassWizard 对话中的 Messages 框相同的信息，但更加易于使用，且更加便于浏览。
Add Member Functio n（添加成员函数）：向当前类添加存

根成员函数。像下图如示那样，输入该函数的返回类型、声明和访问标签。

第三部分编程帮助工具 - 图10

Visual C++ 将这个新函数的声明和定义代码都添加到类源文件。

//In the class header file public:

void NewFunction(int I, Cstring &str);

// In the class CPP implementation file

void CMainFrame::NewFunction(int I, Cstring &str)

{

}

Delet e（删除）：从类的来源中删除当前函数。在查询

确认之后，Visual C++ 把该函数的声明和注释从实现代码中删除。编辑器的 Undo 命令不能恢复已被删除的函数。
Go To Class Definition （转到类）：在当前类的构造器函

数的实现代码处放置插字符。
New Clas s（新建类）：与 Insert 菜单上的 New Class 命令是

等价的。
New Form （新建表单）：显示 New Form 对话，该对话可用

于生成代表从 CFormView ， Cdialog ， CRecordView 或 CDaoRecordView 中派生的基于表单的新类的源代码。该操作与从 New Class 对话中选中 Form

Class 类型产生的结果相同。

Go To Next/Previous Functio n（转向下一个 / 前一个函数）：

在实现文件中，将插字符向前或向后发送到下一个函数定义。在头文件中，将插字符发送到邻近的函数声明。
Open Include File （打开包括文件）：扫描当前文档查找

#include 语句，然后展示一个带有包括文件的列表。如果想在文本编辑器中打开一个文件，请在列表中双击它的文件名。
- WizardBar Help （向导栏帮助）：在 MSDN Help 窗口中显
  示一个题为“ OverView: WizardBar” 的话题。从那里，你可以跳到与 W izardBar 有关的其他话题。

W izardBar 提供了到 ClassWizard 的快速访问，是 ClassWizard 对话的替代方法，使用起来很方便。一旦你知道了 ClassWizard 的输入与输出，W izardBar 的功能看上去就很熟悉了。尽管本章将重点放在通过各种对话框来访问 ClassWizard 之上，该信息同样可以应用到 W izardBar 工具。

ClassWizard 如何识别类

CLW 数据库文件是以 ASCII 文本形式存在的，因此你可能对使用文本编辑器阅

读它比较感兴趣。数据库将项目中的每个类进行分类，并记录该类的基和源文件。对话、菜单和加速键这样的资源数据，也用它们的标识符在文件中运行分类。

为了构造 CLW 数据库文件， Visual C++ 扫描附加在该项目之上的每个源文件，寻找特殊的注释行。在前面的 AppWizard 程序中，你已经看到了这些注释；它们以 {/ 或 //} 开头，以起到标记声明、消息映射条目和其他与类成员相关的代码的作用，除了为 CLW 数据库中包括的东西标识类信息之外，注释没有其他的作用。如果你没有使用 ClassWizard 写一个类，而后来又想使用 ClassWizard 向该类添加其他的函数或数据，那么你必须包括注释行。否则，注释就不是必要的。

每个注释限定符都包含表 6-7 中列出的十三个关键字中的一个。大多数关键字是成对使用的，一个关键字用来标记类的头文件中的一条声明，而它的对应物（带有 _MAP 后缀）标记的是 CPP 文件中消息映射中的相应条目。例如，这里是 Visual C++ 如何识别名为 CDemoApp 中消息处理程序函数的例子，其中 CDemoApp 是从 MFC 的 CWinApp 中派生出来的。在 CPP 实现文件中，特殊的 AFX_MSG_MAP 注释将代表处理程序函数 CDemoApp::OnAppAbout 的消息映射条目括了起来，使得该条目可以被 ClassWizard 所识别。

BEGIN_MESSAGE_MAP(CDemoApp, CWinApp)

//{{AFX_MSG_MAP(CDemoApp) ON_COMMAND(ID_APP_ABOUT, OnAppAbout)

//}}AFX_MSG_MAP END_MESSAGE_MAP()

表 6-7 ClassWizard 所需要的注释关键字

关键字	文件	说明
AFX_DATA	H	用于对话数据交换的成员变量声明
AFX_DATA_INIT	CPP	对话类的构造器中对话数据交换变
		量的初始化
AFZ_DATA_MAP	CPP	对话类的 DoDateExchange 函数中的对话数据交换调用
AFX_DISP	H	自动声明
AFX_DISP_MAP	CPP	自动映射
AFX_EVENT	H	ActiveX 事件声明
AFX_EVENT_MAP	CPP	ActiveX 事件映射

续表

AFX_FIELD_INIT	CPP	初始化记录集类的构造器中的记录字段交换成员变量
AFX_FIELD_MAP	CPP	记录类的 DoFieldExchange 成员函数中的记录字段交换调用
AFX_MSG	H	在消息映射中出现的函数变量
AFX_MSG_MAP	CPP	消息映射条目
AFX_VIRTUAL	H	虚拟函数超越的声明

ClassWizard 还需要读取该函数的原型，因此头文件中的 OnAppAbout 声明相应的 AFX_MSG 注释进行标记：

public:

//{{AFX_MSG(CDemoApp) afx_msg void OnAppAbout();

//}}AFX_MSG

DECLARE_MESSAGE_MAP()

有了这条记录在 CLW 数据库中的信息， ClassWizard 就可以知道， CDemoApp 类包含有一个名为 OnAppAbout 的成员函数，当程序接收到包含在W M _ C O M M A N D 消息中的 ID_APP_ABOUT 标识符的时候，便调用该成员函数。函数中的 afx_msg 前缀是为了 ClassWizard 才包括进来的，否则，它是不需要的。ClassWizard 和 AppWizard 可以在生成源代码的时候自动添加正确的限定符注释。但是，如果你想在不是用 AppWizard 开始的项目中，使用 ClassWizard 的话，表 6-7 显示了如何转换现有的源文件，使它们可以被 ClassWizard 所识别。该表说明了由注释关键字所标记的函数和声明的类型，并且指示了关键字在哪个源文件中使用。

用 ClassWizard 创建对话类

在为新的 MFC 程序设计了新的对话资源之后，你必须还提供从 CDialog( 或者其他基于对话的类 ) 中派生的类，来显示对话和响应它的消息。通常情况下，在用对话编辑器完成之后， ClassWizard 是你的下一个逻辑步骤。例如，当我们在第 5 章中编写 MfcTree 程序的时候，就曾经用过 ClassWizard 。M fcTree 显示的是一个包含有一些 MFC 类的树状列表的简单对话。在第 5 章中，我们编写了一个叫做

CMfcDlg 的类来运行这个对话，首先使用文本编辑器来编写主要的实现文件和头文件，名字分别为 M fcDlg.cpp 和 M fcDlg.h ，然后通过从 Insert 菜单选择 Add To Properties 命令来将这些文件添加到项目中。这两个步骤都可以由 ClassWizard 运行处理。

做为例子说明，让我们再次创建主要的 M fcDlg.cpp 和 MfcDlg.h 文件。这次使用ClassWizard ，而不是在文本编辑器中从零开始编写文件。为了清楚地了解ClassWizard 自动完成的工作，你可能想回顾一下第 5 章题为 “ 为 CMfcDlg 对话类添加源文件 ” 一节的内容。该节介绍了创建 M fcTree.exe 所使用的五个步骤中的第三步。

在开始这个练习的时候，假设 M fcTree 的对话刚刚创建，并且保存在对话编辑器之中。在 IDD_MFC_DIALOG 资源仍在对话编辑器中处于打开状态的时候，请单击 View 菜单上的 ClassWizard 。 ClassWizard 将检测新的对话资源，并且询问你是否愿意为它创建一个新类。

第三部分编程帮助工具 - 图11

我们可以向已经存在源代码的类中添加类。例如，你在对话编辑器中创建和保存资源之前，可能已经编写了对话类。在这种情况下，你应该单击 Select An Existing Class（选择现有类）单选按钮，将对话附加到类上。并且阻止 ClassWizard 生成

新的 CPP 和 H 源文件。不过，对于本例，既然 C M fcDlg 类还没有存在，那么，

Create A New Class （创建新类）单选按钮便是正确的选择。

单击 O K 按钮打开相似的 New Class 对话。在 Name 框中输入 C M fcDlg ，将为新类取一个名字。跳过 Change 按钮，接受 ClassWizard 为源文件建议的 MFcDlg.cpp 和 MfcDlg.h 默认名字。因为它知道我们正在为这个新对话创建一个类，所以ClassWizard 已经选中了 CDialog 作为基类。它还用对话编辑器写向 MfcTree.rc 文件的对话标识符 IDD_MFC_DIALOG ，来填充 Dialog ID 框，图 6-8 显示了 New Class 对话框的样子。

第三部分编程帮助工具 - 图12

6-8 在 ClassWizard 的 New Class 对话中创建新 CMfcDlg 类

单击 O K 按钮来关闭 New Class 对话，并再现如图 6-9 所示的 MFC ClassWizard 对话，这就是你为新的 CMfcDlg 类生成主体代码的地方。 CMfcDlg 仅仅需要OnInitDialog 函数，它刚好在 IDD_MFC_DIALOG 对话出现之前获得控制权。在Object IDs 框中，选中 CMfcDlg ，然后双击 Messages 栏中的 W M _INITDIALOG 来添加 OnInitDialog 函数。

第三部分编程帮助工具 - 图13

图 6-9 向 CMfcDlg 类添加 OnInitDialog 成员函数

ClassWizard 创建的两个成员函数的名字出现在对话底部的 M ember Functions 框中。框中选中的项目用来指示当程序接收到 WM_INITDIALOG 消息的时候， ON_WM_INITDIALOG 消息映射宏负责对 OnInitDialog 函数的日常控制。CMfcDlg 树状视图中的项目保持不变，因此，也就不需要 DoDataExchange 函数。如果你想删除 DoDataExchange ，请在 M ember Functions 框中选中它，并单击Delete Function 按钮。不过，这样做只能从 M fcDlg.h 头文件中删除函数原型：

//{{AFX_VIRUAL(CMfcDlg) protected;

virtual void DoDataExchange(CDataExchange* pDX); //DDX/DDV support

//}}AFX_VIRTUAL

DoDataExchange 源代码仍旧在 MfcDlg.cpp 文件中存在。原因是 ClassWizard 仅仅删除了注释限定符之内的代码，而从不删除实现代码。一条消息可以提醒你注意这个事实：

第三部分编程帮助工具 - 图14

如果单击 Yes 按钮，就是同意将在文本编辑器中删除 DoDataExchange 源代码。如果你后来想将函数添回到 M fcDlg.cpp 文件，便会有两次定义 DoDataExchange 的危险。当 ClassWizard 添加一个新的成员函数的时候，它应首先扫描文件，看看函数是否已经存在，它只是编写新的函数外壳：

void CMfcDlg::DoDataExchange(CDataExchange* pDX)

{

Cdialog::DaDataExchange(pDX);

}

如果删除 DoDataExchange 的原始实现失败，将会导致编译错误，因为编译器不能接受同一函数的两个定义。

在退出 MFC ClassWizard 对话的时候，ClassWizard 将向项目添加新的 MfcDlg.cpp 和 MfcDlg.h 文件，这两个文件都包含有用于 CMfcDlg 类的存根函数。一旦你向第 5 章中介绍的那样，在类的 OnInitDialog 函数中添加了代码，这些新文件在功能上与从头开始编写的文件是等价的，而且，更加易于创建。如果你愿意比较新的源代码，可以在配套光盘的 Chapter.05\ M fcTree 文件夹中找到原来的 M fcDlg 源文件。在 ClassWizard 的帮助下生成的相应的 MfcDlg.cpp 和 M fcDlg.h 文件位于 Chapter.06\ M fcTree 文件夹中。

第 7 章 Ga llery （组件集）

Gallery 是一类工具箱， M icrosoft 在它里面放置了一类叫做组件的 “ 罐装代码 ”，你可以把它们添加到自己的项目中。还可以使用 Gallery 来保存你以后想再使用的任何属于自己的类。 Gallery 保存三种主要类型的组件：源代码，对话资源和ActiveX 控件。通过 Gallery ，你可以为了寻找某个组件而浏览自己的硬盘或整个网络，然后单击一下鼠标，将它插入到你的项目中。因为组件可以存储在任何地方，所以 Gallery 既可以作为个人代码存储库，存储组件供你个人使用，又可以作为全局性的代码存储库，允许开发网络链向它来共享通用组件集。

Gallery 提供的预先包装好的组件存储在由 Visual C++ 安装程序创建的两个文件夹中。一个文件用于源代码组件，另一个文件夹用于 ActiveX 控件。 Visual C++ Components 文件夹包含有到动态链接库的快捷方式，它可以自动向项目添加源代码和资源。第二个文件夹名字叫做 Registered ActiveX Controls ，它包含有到在你的系统上注册的所有 ActiveX 控件的快捷方式链接。有些注册的控件是由Visual C++ 经过许可后提供的，因此，你可以在自己的应用程序之中重新分布它们。有关 ActiveX 控件有很多地方值得一提，它们中的大部分不直接附属于Gallery, 因此，直到本书第四部分，才能涉及这方面的话题。本章把重点放在如何访问 Gallery 以及创建你自己的可重用的对象集上。

对于预包装的组件来说， Visual C++ 不是唯一可提供的资源。许多销售商以源代码和二进制两种形式提供组件工具，并且在商业期刊和 Internet 上做广告。预包装的组件比你自己创建的更加方便，因为它们可以自动实现向项目添加组件的全部过程。通过操作 Visual C++ 环境加载和运行的可执行库，这些专业组件可以通过在必要的时候添加函数和 #include 语句（通常很少或干脆就没有为你留下编程工作的地方）来插入图形资源，并重写现有的项目文件。预包装组件通常提供有它们自己的在线帮助。

Gallery 在如图 7-1 所示的 Components And Controls Gallery 对话中显示它的组件。当一个 C++ 项目在环境中处于打开状态的时候，可以通过将光标暂时停留在Project 菜单上的 Add To Projec t（添加到项目）命令上来访问 Gallery 对话。该操作将显示一个二级下拉式菜单，你可以从中选择 Components And Contro l（组件和控件）命令。当你从列表中选中一个组件时，如果该对话的 M ore Info 按钮是启用的，那么该组件便可以通过在线帮助来描述自己。如果想把一个 Gallery 组件插入到项目中，请选中它的图标，并单击 Insert 按钮。

第三部分编程帮助工具 - 图15

图 7-1 Gallery 的 Visual C++ 组件文件夹

在 Visual C++ 版本 4 中，如果你总是用 AppWizard 创建项目， Gallery( 就是所熟知的 Component Gallery) 将会变得很拥挤。每当 AppWizard 执行的时候，它都自动向 Component Gallery 添加新类，并且安装所有的项目类 ( 例如 CMainFrame 和CAboutDlg) 作为源代码组件。在默认状态下， ClassWizard 还向项目分类添加你所创建的任何新类。清除 Component Gallery 中不想要的附件的责任就交给用户了，尽管许多程序员只是忽略展开的组件列表，或没有注意到 AppWizard 和ClassWizard 在幕后做了些什么。整个 Component Gallery 数据库存储在一个叫做Gallery.dat 的单个文件之中，因此没有方便的方法可以与其他开发者一起共享组件。

尽管版本 6 中 Gallery 的函数没有改变，但它的方法已经得到了很大改进。Gallery.dat 不再存在，它的数据库已被存在于磁盘或网络上任何地方的单个组件文件所取代。 AppWizard 和 ClassWizard 都不再向 Gallery 添加类。正如我们将在下一章中所看到的，ActiveX 控件可以成为 Gallery 数据库的一部分，而无需你的许可，但是，对于其他组件类型则不可以。你必须采用特殊的步骤才能把组件添加到 Gallery ，其中包括你想从版本 4 中继承的任何组件。下一节将解释如何向Gallery 添加新组件，现在，让我们来看一看 Visual C++ 中提供的预包装组件。

例子：添加一个属性表

第 5 章介绍了如何使用编辑器来创建属性表对话，并将其融入一个程序。Gallery

提供了一个叫做 Property Sheet 的组件，利用它，工作起来就会更加容易。本节和下一节将阐述 Property Sheet 以及 Visual C++ 提供的一些其他组件，首先显示如何向叫做 Gadgets 的项目添加属性表，然后用从 Gallery 中借用的更多代码来充实和完善程序。 Gadget 作为一个典型的 AppWizard 项目启动，然后，随着你不断地添入组件，它会变得越来越高级。下面是建立项目并添加第一个组件的步骤：

从 File 菜单选择 New 对话，在 Projects 选项卡中选择

AppWizar d（ exe ）图标。键入 Gadgets 作为项目名并单击 OK 。
当 AppWizard 在屏幕上依次出现各个步骤时，在第一步

中选中 Single Document 单选按钮，并且在第四步中解除对状态栏、停靠工具栏和打印支持的选择。在其他步骤中接受默认的设置。
当 AppWizard 完成，而且 Visual C++ 打开项目的时候，从

Project 菜单中选择 Add To Project, 并单击位于次级菜单上的 Components And Controls 命令，来显示 Components And Controls Gallery 对话。
在对话中打开 Visual C++ Components 文件夹，并双击

Property Sheet 组件图标 ( 为了找到该图标，你可能不得不从头至尾滚动列表。Gallery 出现一个消息框，询问你是否确实想插入这个组件。
Visual C++ 加载并执行这个组件的可执行库，它将显示

一个对话，询

问与你想创建的属性表类型有关的各种问题，只需单击 Next 按钮，接受所有的默认设置即可。完成之后，关闭 Gallery 对话。

你将会发现， Property Sheet 组件已经为新的属性表类的源文件自动放进了Gadgets 文件夹。该组件还修改了 Gadget 项目中四个现有的文件， Resource.h 文件包含有属性表类所需要的定义， Gadgets.rc 文件已用代表两个属性页的脚本进行了更新， M ainFrm.h 和 M ainFrm.cpp 文件包含有用于新的名为 OnProperties 的函数的新代码。

OnProperties 函数中的“ to do ”注释解释了你必须将该函数连接到消息处理程序，这样，当用户单击菜单命令的时候，属性表才能显示出来。该操作仅需要两步：

1 .在 M ainFrm.cpp 中，将代表该函数的条目添加到消息映射。新的映射条目在这里显示为阴影，它必须插在 ClassWizard 注释限定符之间：

//{{AFX_MSG_MAP(CMainFrame) ON_COMMAND(IDM_PROPSHEET, OnProperties)

//}}AFX_MSG_MAP

2. 在 Workspace 窗口的 ResourceView 窗格中，展开 M enu 文件夹，并双击 IDR_MAINFRAME 菜单编辑器。编辑该菜单系统，使它如下图所

示：

第三部分编程帮助工具 - 图16

当你向 Option 菜单添加 Property Sheet 命令的时候，一定要在 M enu Item Properties

（菜单项属性）对话中给它一个 IDM_PROPSHEET 的标识符值。这与第一步中添加到消息映射中的阴影行所使用的标识符是相同的。

使用 Build 的工具栏，可以将活动项目配置改为 W in32 Release ,创建 Gagets.exe ，并运行它。从程序的 Option 菜单中选择 Property Sheet 命令，将显示如图 7-2 所示的属性表。在对话的这两页中，准备使用对话编辑器向其中添加控件。从开始到完成，整个操作仅需要几分钟。你可以轻轻松松地创建属性表，这是前所未有的。

第三部分编程帮助工具 - 图17

图 7-2 显示有属性表的 Gadgets 程序

例子 : 添加初始屏幕和时钟

初始屏幕是位图图像，它在程序启动的时候出现一会儿。在加载文件和实现其他初始化操作的时候，大的 Windows 程序 ( 例如 Visual C++ ，甚至是 Windows 自已 ) 通常要在显示一个主窗口之前出现一个初始屏幕。这不仅仅可以在程序忙的时候为用户提供一些吸引人的东西，而且还可以起到表达系统响应的效果。 Gadget

程序十分小，因此，它不需要初始屏幕，但这也没关系。让我们添加一个带有时钟的状态栏。你可能不会想相信，这非常简单。

我们所需要的组件叫做 Splash Screen 和 Status Bar, 在 Gallery 对话的 Visual C++ Components 文件夹中，它们是用这些大图标标识的。

第三部分编程帮助工具 - 图18

通过双击组件图标可以将每个组件添到打开的 Gadgetes 项目之中。 Status Bar 组件运行了一个对话，让你选择新状态栏是否显示日期和时间。如果想在状态栏中包括时间，请在第二步中单击 Use System Defaul t（使用系统默认值）单选按钮 ( 对于其他步骤接受默认设置 )。在关闭 Gallery 时，你将会发现创建在最右边带有小时钟状态栏的代码已添加到 MainFrm.cpp 文件之中。你只需将阴影行添向M ainFrm.cpp 文件的消息映射中即可：

//{{AFX_MSG_MAP(CMainFrame) ON_COMMAND( IDM_PROPSHEET, OnProperties ) ON_WM_CREATE ()

//}}AFX_MSG_MAP

Splash Screen 组件提供了一个名为 Splsh16.bmp 的文件，它包含一个位图图像。

对于你自己设计的初始屏幕，在图形编辑器中创建一个新的 16 色图像，并将其保存在相同的文件名之下，覆盖掉原来的 Splash16.bmp 文件。初始屏幕默认的持续时间是 3/4 秒 (750 毫秒 )，但是，你可以通过在 Splash.cpp 文件中修改如下代码来改变它：

SetTimer(1,750,Null);

如果想看到有效的新组件，请重建 Gadgets 程序，并运行它。图 7-3 显示了新程序的样子。

第三部分编程帮助工具 - 图19

图 7-3 带有新的初始屏幕、状态栏和时钟的 Gadgets 程序

创建自定义的组件

Gallery 是无限可扩展的。你可以通过创建自定义的组件（例如对话框或新类），将它们添加到新的集合中。对于类来说，自定义的组件由源代码组成，通常是单个的 CPP 实现文件和 H 头文件。如果这个类是从 MFC 对话类 (CDialog, CFormView, CPropertyPage, CRecordView 或 CDaoReardView )中派生出来的，那么，该组件还包括用于该对话的资源数据。

应当把你的工作作为一个新组件来保存，理由如下。首先， Gallery 可以做为存储可重用源代码的仓库来使用。当你为一个项目开发一个类，并将其作为一个组件来保存的时候，你不必为了将该类添加到新项目而搜索磁盘文件来查找源代码。创建新组件的第二个原因是通过网络链接的开发者的特殊需要，他们现在可以向中心组件“ 银行 ” 中添加组件，或从中调用组件。在开发新类之前，你可以检查一下 Gallery ，看看是否有人已经为你做了这项工作。

如果想向 Gallery 添加一个组件，请在 Workspace 窗口的窗格中右击它的类，并从上下文菜单中选择 Add To Gallery （添加到组件集）命令。图 7-4 说明了为名为 CNewComponent 的类的添加步骤。

如果必要的话，单击 Add To Gallery 命令将创建一个新的文件夹。该子文件夹具有与项目相同的名字，并且包含新的具有 OGX 扩展名的组件文件。OGX 组件文件不是指向原始类源代码的指针；它包含有定义该类的 CPP 和 H 文本文件的绑

定副本。如果该类是基于对话的，那么 O G X 文件便存档了代码对话资源脚本的一个副本。因为 OGX 文件存档了代码的完整副本，所以，一个组件可以在它的项目消失后依旧存在。即使项目被删除或移动了， Gallery 总是可以产生原始的资源代码。这就意味着，在将组件添加到 Gallery 时代码的快照便是组件。组件不是与源代码一起自动更新的；如果想更新组件，你必须再次向 Gallery 添加该类。

第三部分编程帮助工具 - 图20

图 7-4 向 Gallery 添加一个类

你所创建的自定义组件有一定的局限。一是对于自定义组件， Gallery 对话中的More Info 按钮是非活动的，因为没有直接的方法添加在线帮助，来解释该组件是如何工作的。自定义组件也不能像 Property Sheet 和 Splash Screen 组件所做的那样，自动修改项目中现有的源文件。要创建适合于软件市场的专业质量的组件，需要 M icrosoft 的 Component Builder's Kit ，利用它，可以创建可使用在线帮助系统的可执行组件。 M icrosoft 不再为该工具箱收取费用，但目前只能提供给软件公司，不能提供给个人。如想申请 Builder's Kit 的副本，请在你的公司的信头上向如下地址发送一个请求。

Visual C++ Manager Microsoft Corporation One Microsoft Way

Redmond, WA 98052-6399

例子：用于目录列表的自定义组件

本节说明创建自定义组件的过程，首先规划出一个名为 CDirListCtrl 的新类，然后将它添加到 Gallery 。 CDirListCtrl 是从 MFC 的 CListCtrl 类中派生的，它在列表视图通用控件中显示目录列表，并附加上帮助你迅速区分驱动器、文件夹或文

件的小图标（见图 7-5 ）。单击列表中的驱动器或文件夹将自动改变路径并刷新列表。因为 CDirListCtrl 不使用 D lgDirList API 函数，所以，它可以在 W indows 95 中正确显示长文件名。如果这与我们在第 5 章中为 D irList1 程序所使用的一些东西相像，那么你就对了。后一节将显示为了创建叫做 D irList2 的程序的新版本而添加 D irListCtrl 自定义组件。

第三部分编程帮助工具 - 图21

图 7-5 典型对话框中的 CDirListCtrl 列表视图控件

列表 7-1 显示了 CDirListCtrl 类的源代码，包含在本书配套光盘 Code\Chapter.07\ D irCtrl 文件夹中的 D irCtrl.h 和 D irCtrl.cpp 文件中。CD .CDirlistCtrl 包含五个公共成员函数，其中有三个在 D irListCtrl 头文件中声明。在其余两个之中， Create 用于建立列表视图控件， ShowList 用于刷新该控件中的目录列表。显示的目录路径存储在私有的 StrDirectory 字符串之中。改变列表是两步过程，在该过程中， CDirListCtrl 对象的创建者首先调用 SetPath 函数来改变目录路径，然后调用

ShowList 来显示新目录。

表 7-1 CDirListCtrl 类的源文件

DirCtrl.h

// ********************************************************************

// DirCtrl.h

// ********************************************************************

#define DL_DRIVE 1

#define DL_FOLDER 2

#define DL_FILE 4

#define DL_ALL 7

typedef BOOL (CALLBACK *PCALLBACK)( PWIN32_FIND_DATA );

class CDirListCtrl : public CListCtrl

{

private:

int iListFlags, idcPath;

CString strDirectory, strFilter;

CListBox listDummy;

CImageList imageList;

CDialog* pDialog;

BOOL FindFiles( DWORD dwFlags );

void GetCurrentDirectory ();

PCALLBACK pCallBack;

public:

BOOL ShowList( CString& Filter );

void GetPath( CString& strPath ) { strPath = strDirectory; }

void SetPath( CString& strPath ) { strDirectory = strPath; }

void SetCallBack( PCALLBACK pCB ) { pCallBack = pCB; }

void Create( CDialog* pDlg, LPRECT prect, int idcControl,

int idcStatic, int iFlags=DL_ALL, int idiIcon=0 );

protected:

BOOL GetDirectoryList( int iType );

afx_msg void OnSelChange( NMHDR* pnumhdr, LRESULT* pResult );

DECLARE_MESSAGE_MAP ()

};

DirCtrl.cpp

// ********************************************************************

// DirCtrl.cpp

// ********************************************************************

#include "afxcmn.h"

#include "dirctrl.h"

#define IDC_DUMMY 48888

void CDirListCtrl::Create( CDialog* pDlg, LPRECT prect, int idcControl,

int idcStatic, int iFlags, int idiIcon )

{

pDialog = pDlg; // Save ptr to dialog object

idcPath = idcStatic; // Save ID of static control

pCallBack = NULL; // Assume no call-back

// Create DirListCtrl control

if (!CreateEx( WS_EX_CLIENTEDGE, WC_LISTVIEW, NULL,

LVS_LIST | LVS_SINGLESEL | LVS_ALIGNLEFT | WS_VISIBLE | WS_CHILD,

WS_VISIBLE | WS_CHILD,prect->left,prect->top,

prect->left, prect->top, prect->right, prect->bottom,

pDialog->m_hWnd, (HMENU) idcControl ))

{

MessageBox( "Failed to create DirListCtrl" );

return; } // Associate "file", "folder", and "drive" icons with DirListCtrl control imageList.Create( 16, 16, TRUE, 1, 0 ); if (idiIcon) {
	imageList.Add( AfxGetApp()->LoadIcon( idiIcon )	);		// Floppy
	imageList.Add( AfxGetApp()->LoadIcon( idiIcon +	1	) );	// Hard
	imageList.Add( AfxGetApp()->LoadIcon( idiIcon +	2	) );	// CD-ROM
	imageList.Add( AfxGetApp()->LoadIcon( idiIcon +	3	) );	// Folder
	imageList.Add( AfxGetApp()->LoadIcon( idiIcon +	4	) );	// File
}

SetImageList( &imageList, LVSIL_SMALL );

// Create dummy list box

CRect rectDummy;

rectDummy.SetRectEmpty ();

listDummy.Create( WS_CHILD | LBS_SORT, rectDummy, pDialog, IDC_DUMMY );

// Start with current directory

GetCurrentDirectory ();

iListFlags = iFlags;

}

BOOL CDirListCtrl::ShowList( CString& Filter )

{

static int iType[3] = { DL_DRIVE, DL_FOLDER, DL_FILE };

BOOL bRetCode = FALSE;

int i, j, n, nIcon, nItem = 0;

UINT uType;

PSTR pItem = new char[MAX_PATH];

char szRoot[] = {"x:\\\0"}-->;

if (Filter.IsEmpty ())

strFilter = "*.*";

else

{

strFilter = Filter;

strFilter.TrimLeft (); // Remove any leading

if (strFilter.GetAt( 0 ) == '\\') // white spaces or

{ // backslash

strFilter.SetAt( 0, ' ' );

strFilter.TrimLeft ();

}

// Update static control and empty the list

pDialog->SetDlgItemText( idcPath, strDirectory );

DeleteAllItems ();

// Display directory list in this order: drives, folders, files

for (n=0, j=DL_DRIVE; n < 3; n++, j <<= 1)

{

if ((iListFlags & j))

{

if (GetDirectoryList( iType[n] ))

{

bRetCode = TRUE;

// Copy list from dummy box to list view control

i = 0;

while (listDummy.SendMessage( LB_GETTEXT, i++,

(LPARAM) pItem ) != LB_ERR)

{

if (lstrcmp( pItem, "." ) &&

lstrcmp( pItem, ".." ))

{

// Determine which icon the listed item

// should have:floppy, hard disk, etc.

switch (j)

{

case DL_DRIVE:

szRoot[0] = *pItem;

nIcon = 1;

uType = ::GetDriveType( szRoot );

if (uType == DRIVE_REMOVABLE)

nIcon = 0;

if (uType == DRIVE_CDROM)

nIcon = 2;

break;

case DL_FOLDER:

nIcon = 3;

break;

default:

nIcon = 4;

}

InsertItem( nItem, pItem, nIcon );

SetItemData( nItem++, iType[n] );

}

delete [] pItem; // Clean up

return bRetCode;

}

BEGIN_MESSAGE_MAP (CDirListCtrl, CListCtrl)

ON_NOTIFY_REFLECT (LVN_ITEMCHANGED, OnSelChange)

END_MESSAGE_MAP ()

void CDirListCtrl::OnSelChange( NMHDR* pnumhdr, LRESULT* pResult )

{

NM_LISTVIEW* pnmlv = (NM_LISTVIEW*) pnumhdr;

// Get item selected in list view

if ((pnmlv->uNewState) & LVIS_FOCUSED)

{

// Is it a drive, folder, or file?

int iType = GetItemData( pnmlv->iItem );

if (iType != DL_FILE) // Ignore it if it's a file

{

CString strItem = GetItemText( pnmlv->iItem, 0 );

// If drive selected, replace directory

if (iType == DL_DRIVE)

strDirectory = strItem; // Directory = "d:"

// If folder selected, append it to current path

else

strDirectory += strItem; // Append string "subdir"

strDirectory += "\\"; // In either case, append '\'

if (!ShowList( strFilter )) // New directory listing

{

// If error, reset to current directory

GetCurrentDirectory ();

strFilter.Empty ();

ShowList( strFilter );

}

*pResult = 0;

}

BOOL CDirListCtrl::GetDirectoryList( int iType )

{

DWORD dwDrives;

char szDrive[] = "A:";

BOOL bRet;

// Empty the dummy list box

listDummy.SendMessage( LB_RESETCONTENT, 0, 0 );

switch (iType)

{

case DL_DRIVE:

dwDrives = ::GetLogicalDrives ();

for (; dwDrives && szDrive[0] <= 'Z'; ++szDrive[0])

{

if (dwDrives & 1)

listDummy.SendMessage( LB_ADDSTRING, 0,

(LPARAM) szDrive );

dwDrives >>= 1;

}

bRet = TRUE;

break;

case DL_FOLDER:

bRet = FindFiles( FILE_ATTRIBUTE_DIRECTORY );

break;

case DL_FILE:

bRet = FindFiles( 0L );

break;

}

return bRet;

}

BOOL CDirListCtrl::FindFiles( DWORD dwFlags )

{

WIN32_FIND_DATA fd;

HANDLE hFind;

CString str = "*.*";

BOOL bOkay;

if (dwFlags == 0)

str = strFilter;

hFind = ::FindFirstFile( strDirectory + str, &fd );

if (hFind == INVALID_HANDLE_VALUE)

return FALSE;

while (TRUE)

{

if (dwFlags == (fd.dwFileAttributes &

FILE_ATTRIBUTE_DIRECTORY))

{

bOkay = (pCallBack) ? pCallBack( &fd ) : TRUE;

if (bOkay)

listDummy.SendMessage( LB_ADDSTRING, 0, (LPARAM) fd.cFileName );

}

if (!::FindNextFile( hFind, &fd ))

break;

}

::FindClose( hFind );

return TRUE;

}

void CDirListCtrl::GetCurrentDirectory ()

{

PTSTR pDir = new char[MAX_PATH];

仅仅为了创建控件而调用一次的 Create 函数，在 D irCtrl 头文件中，其原型为：

void Create( CDialog* pDlg, LPRECT prect, int idcControl, int idcStatic, int iFlags=DL_ALL, int idiIcon=0 );

表 7-1 解释了该函数的六个参数。

调用者可以在它的资源代码中最多提供五个图标图像，每个 16 像素形成一个正方形，它们代表了在列表视图控件中显示的各种驱动器类型和文件名。图 7-5 显示了可能的图标图像，它们包括软盘驱动器、硬盘、 CD-ROM 驱动器、文件、文件夹以及代表文件的小钻石形状。Create 函数通过调用 CImageList::Add 函数，

可以将每个图标附属到控件，由 idiIcon 参数标识以软盘驱动器图标作为开始。因此 idiIcon+1 代表硬盘图像的标识符；idiIcon+2 是代表 CD-ROM 驱动器图像的标识符；等等。图标是可选的，也可以不使用它。

表 7-1 Create 函数的参数

参数说明

pDlg 用于包含对话框的 this 指针

prect 指向包含在对话窗口内列表视图控制的维数的

RECT 结构

idcControl 列表视图控件的标识符

idcStatic 对话中静态控件的标识符。 ShowList 函数将当前的目录路径写到 idcStatic 控件

续表

iFlags 在 D irCtrl.h 中定义的位标志，由它来确定目录所列出的内容。值可以是 DL_DRIVE, DL_FOLDER 和DL_FILE 的任意组合，默认的 DL_ALL 值包括列表中所有的三种类型

idiIcon 用于在目录列表中显示的五个图标中的第一个标识符值

Create 函数在退出之前调用 CListBox::Create ，来建立一个名为 listDummy 的不可见的列表框控件。 listDummy 列表框从来都不显示，它仅仅作为组成目录列表的文件名的中间存储仓库。FindFiles 函数在目录中定位的每个文件夹的名字被添加到 listDummy 列表框。既然该列表框是用 LBS_SORT 标志创建的，那么，当它接收到每个文件和文件夹名字的时候，它会自动将它的字符集进行分类。当ShowList 函数从列表框中展开字符串的时候，该列表框将该按字母顺序一个接一个地传送字符。

SetCallBack 内嵌函数用于取得一个可选的回调例程的地址。如果 PCallBack 地址为非空，那么， FindFiles 函数就假定回调例程存在，并在将文件名添加到listDummy 列表框之前，为每个文件调用它：

bOkey = (pCallBack) ? pCallBack(&fd):TRUE; if(bOkey)

listDummy.SendMessage(LB_ADDSTRING, 0, (LPARAM))fd.cFileNAme;

通过从回调例程中返回 TRUE 或 FALSE ， CDirListCtrl 对象的创建者可以接受和拒绝任何文件。在本章稍后，我们将看到 DirList2 程序是如何利用该项功能来为目录列表中所显示的文件打开窗口的。

创建 CDirListCtrl 类

在作为组件添加 CDirListCtrl 之前，我们需要一个临时项目来包含源文件。这是因为 Workspace 窗口的 ClassView 窗格只能在打开的项目中才能访问。因此，当你想添加到 Gallery 的类作为不属于项目的源代码存在时，创建一个临时类是很有必要的。一旦该类已被添加到 Gallery ，你就可以删除这个临时项目了。项目名无关紧要。

你可以用两种方法创建一个临时项目来包含现有的类。第一种方法依赖于AppWizard 。在 File 菜单上单击 New ，在 Projects 选项卡中选择 MFC AppWizard (exe) 图标，键入项目名 ( 下面所概括的步骤假定项目名为 D irCtrl) 。单击 AppWizard 中的 Finish 按钮来接受所有的默认设置，这并不重要的原因是，我们将抛弃所有的生成文件。

为包含组件类而创建临时项目的第二种方法不依赖于 AppWizard 。这样一个项目仅仅需要一个与项目同名的存根 RC 文件。甚至这个 RC 文件可以是空的。如果想创建这个项目，请在 New 对话中的 Projects 选项卡中选中 Win32 Application 图标 ( 而不是 AppWizard 图标 )，给项目取一个名字 ( 例如 D irCtrl) ，然后单击 O K 。在该向导的下一步，接受指定空项目的默认设置，单击 Finish 按钮。下一步，使用文本编辑器来创建一个空的 RC 文件，并将其保存到 D irCtrl 项目文件夹。在新项目处于打开状态的时候，从 Project 菜单选择 Add To Project 命令，并单击次级菜单上的 File s。在 Insert Files Into Project 对话中双击存根 RC 文件，将其添加到项目，这就是启用 ClassWizard 所需要做的所有工作，现在可以通过 View 菜单上的 ClassWizard 命令访问 ClassWizard 了。当调用 ClassWizard 的时候，Visual C++ 将检测到用于该项目的 CLW 文件不存在，并提供它以创建一个新文件。你必须单击 Ye s，并在随后出现的 Select Source File s（选择源文件）对话中单击 O K 来继续 MFC ClassWizard 对话。

无论使用哪一种方法来创建新项目，都要单击 MFC ClassWizard 对话中的 Add Clas s（添加类）按钮，然后选择 New ，来调用如图 6-4 所示的 New Class 的对话。键入 CDirListCtrl 作为类名，选择 CListCtrl 作为基类。单击 Change 按钮，将所生成的源文件重命名为 DirCtrl.h 和 DirlCtrl.CPP 。当你关闭 ClassWizard 对话的时候， Visual C++ 将编写用于新 CDirListCtrl 类的存根代码，并且将文件自动添加到项目中。

第二步是为新类提供源代码。将 D irCtrl.cpp 和 D irCtrl.h 文件从本书配套光盘的

Code\Chapter.07\Dirctrl 文件夹复制到 DirCtrl 项目文件夹，覆盖掉 ClassWizard 刚刚创建的存根文件。还将文件 D irCtrl.rco, Floppy.ico, HardDisk.ico, CD-ROM.ico,

Folder.ico 和 File.ico 复制到项目文件夹，以后将需要这些文件。创建 CDirListCtrl 组件

CDirListCtrl 目前是一个正在开发的类，还不是已完成的和可以使用的组件。展现项目的 ClassView 窗格，并单击类列表中的 CDirListCtrl，然后从如图 7-4 所示的上下文菜单中选择 Add To Gallery 命令。 Visual C++ 把 D irCtrl.cpp 和 D irCtrl.h 组成一个名为 D irListCtrl.ogx 的单一文件，并将这个 OGX 文件存储在名为 DirCtrl 的新 Gallery 文件夹中。下面几段将详细介绐这个新的 Gallery 文件夹，因此，不要将它与原来的 D irCtrl 项目文件夹弄混了。

打开 Gallery 中的 D irCtrl 文件夹看看这个新组件，它是以大图标视图的形式出现的。

第三部分编程帮助工具 - 图22

它需要做一些额外的工作，但你可以将它这个组件的外观再装饰一下。第一步是将 O G X 文件移出 D irCtrl 文件夹，并且用快捷方式文件来代替它。右击新的D irListCtrl.ogx 图标，并从上下文菜单中选择 Cut 命令。通过右击大列表框的任何空白区域，并选择 New 命令，在 Gallery 对话的文件夹中创建一个新的子文件夹，为新文件夹取一个像 OGX Files 这样的一般性的名字，然后，将 D irListCtrl.ogx 文件粘贴进这个新文件夹。右击 DirListCtrl.ogx 图标，从上下文菜单中选择 Create Shortcu t（创建快捷方式）命令，然后剪切该快捷方式文件，并将其粘贴回原来的 DirCtrl 文件夹。

我们就要完成了。这时候，原来的 OGX 文件已被移到了一个叫做 OGX Files 的文件夹中，并且为 D irCtrl 文件夹中的一个快捷方式所取代。最后一步是改进D irCtrl 文件夹中快捷方式图标的外观。通过右击该图标，并选择 Renam e，为快捷方式图标提供一个更具说明性的名字 ( 例如 Directory List) 。右击 D irectory List

图标，选择 Properties, 然后单击 Properties 对话 Shortcut 选项卡中的 Change Icon

（更改图标）按钮。输入（或浏览）到你以前曾经从配套光盘中复制的 DirCtrl.ico 文件的路径。当你单击 O K 关闭 Properties 对话的时候，组件现在在 DirCtrl 文件中就应该像这个样子。

第三部分编程帮助工具 - 图23

我们只做了很少的工作，就使组件的外观比我们开始的时候要好。如果你肯付出努力，还可以把所有的新组件文件都放入 OGX Files 文件夹，按照相同的方法用快捷方式来代替它们。

不幸的是， Visual C++ 没有提供简单的方法来将说明附加到类组件上，在 OGX 文件和它的快捷方式中均不可以。只能用文件名来向其他开发者提供有关组件目的的必要信息。创建一个可以描述自己的组件，需要前面提到的 Component Builder's Kit 。图 7-1 显示了当 Dialog 栏组件被选中的时候，第一条说明是如何出现在 Gallery 之中的。尽管已超出了本章的范围，但使用 Builder's Kit 创建 D irectory

List 组件，允许我们在 DIR 图标在对话中被选中的时候，附加上一条类似的说明：

Display a sorted directory listing in a list view control. Complete with icons representing drives, folders, and files.

退出 Gallery 之后，你可以通过在 Gallery 对话中显示 D irCtrl 文件夹，并双击代表 D irectory List 组件的快捷方式，来将 CDirListCtrl 类添加向任何打开的项目。既然组件已被安装到 Gallery 之中， D irCtrl 项目就已经实现了它的目的，不再需要它了。 D irListCtrl.ogx 包含有类源代码，因此你可以安全地关闭这个项目，并且删除原来的 DirCtrl.cpp 和 D irCtrl.h 文件，以及 DirCtrl 项目文件夹中的其他文件。不过，不要删除以前从光盘中复制的 ICO 文件。D irectory List 快捷方式链接指向包含有代表组件的 DIR 图标的 D irCtrl.ico 文件。当你将新 CDirListCtrl 类插入项目的时候，它可能需要部分或全部保留文件，例如 HardDisk.ico 和Folder.ico 。下节将用一个名为 D irList2 的范例程序来说明 D irectory List 组件。

例子 :D irList2 程序

你可能会回想起第 5 章中介绍的 DirList1 程序，它使用了 D lgDirList API 函数来在列表框控件中显示目录列表。该列表不仅在外观上很平淡，而且难以阅读，因为 DlgDirList 不能在 W indows 95 中识别长文件名，所以，它只能在 W indows NT 中显示长文件名。这里所展示的 D irList2 程序通过融入新的 D ireCtory List 组件

克服了这些不足之处。

如图 7-6 所示的 D irlist2 程序与 D irlist1 一样，是基于对话的，它使用属性表与用户进行交互。除了 D irectory List 控件所提供的吸引人的目录列表之外， DirList2

还利用了属性表的 Date 和 Size 选项卡，允许用户按照文件大小或日期对列表进行过滤。例如，程序可以只显示在最后一日中创建容量为 5 到 10KB 之间的文件。使用前面所介绍的 CDirListCtrl 回调功能可以实现其他过滤。

第三部分编程帮助工具 - 图24

图 7-6 DirList2 程序

为使我们添加的内容比较少， D irList2 程序使用了与 D irList1 程序相同的Resource.h 文件和相同的 RC 文件。这些文件的内容在第 5 章中已经列出。如果你愿意自己独立创建 DirList2 程序，并且不执行 Setup 程序来从配套光盘上安装范例项目；请单击 File 菜单上的 New ，并选中 Projects 选项卡。因为 D irList2 不是 AppWizard 程序，所以，请单击 W in32 Application 来创建该项目。在该向导的对话出现时，输入项目名，并接受默认的设置。在 Visual C++ 创建了空项目之后，单击 Project 菜单上的 Settings。在 Project Settings 对话的 General 选项卡中，选择选项， Use MFC In A Shared DLL （在共享的 DLL 中使用 MFC ）。

第三部分编程帮助工具 - 图25

将文件 DirList2.cpp, DirList2.h, DirList2.rc 和 Resource.h 从本书配套光盘的Code\Chapter.07\DirList2 文件夹复制到项目文件夹。还要把 DirList.ico 文件复制到 DirList2\Res 子文件夹，以便 D irList2 有一个应用程序图标。通过从 Project 菜单选择 Add To Project，然后从次级菜单中选择 Files 命令，来将 D irList2.cpp 和D irList2.rc 文件附加到项目上。

因为 DirList2 程序利用了新的 CDirListCtrl 类，所以还需要几个文件。当然，这是练习的整个目的：既然类已经安装在 Gallery 之中了，那么，添加用于CDirListCtrl 的源文件就是一件很容易的工作了。通过再次从 Project 菜单中选择Add To Projec t，并且单击 Components And Controls ，可以打开 Gallery 对话。在Gallery 的 D irCtrl 文件夹中，双击代表新 Directory List 组件的图标。源文件D irCtrl.cpp 和 D irctrl.h 自动从 D irListCtrl.ogx 组件文件中展开并添加到项目中。

不幸的是， Gallery 不能够提供 CDirListCtrl 在目录列表中显示图标所需要的 ICO 文件。除了通过使用 M icrosoft 的 Bulder's Kit 创建该组件之外，没有办法将 ICO 文件与 OGX 文件中的源代码捆绑起来，因此，必须在一步中将所有必要的文件传送给项目。组件的用户必须手工复制 ICO 文件， D irList2 只需要驱动器和文件夹图标，它们包含在位于以前创建的 D irCtrl 项目文件夹的 Floppy.ico, HardDisk.ico, CD-ROM.ico 和 Folder.ico 文件之中。请将这四个文件复制到D irList2\Res 文件夹。

这是额外的步骤，它必须为 D irectory List 这样的自定义组件进行存档。既然自定义组件不能在 Gallery 对话中提供在线帮助，那么，组件提供文档的最好办法就是通过在 CPP 文件的开头包括一块注释。对于 Directory List ，注释应该满足使用该组件的任何项目的四个需要：

ICO 文件必须被复制到项目的 Res 的文件夹。
RC 文件必须包括在控件中用于每个图标的链接。

IDI_FLOPPY	ICON	"res\\Floppy.ico"
IDI_HARDDISK	ICON	"res\\HardDisk.ico"
IDI_CD_ROM	ICON	"res\\CD-ROM.ico"
IDI_FOLDER	ICON	"res\\Folder.ico"
IDI_FILE	ICON	"res\\File"

标识符 IDI_FLOPPY,IDI_HARDDISK,IDI_CD-ROM,IDI_FOLDER

和IDI_FILE 必须在项目的 Resource.h 文件中定义。 IDI_FLOPPY 可以是任何值；其余的标识符值必须依给定的顺序依次增加。
所有使用类的源文件必须包含如下一行。

＃ include "dirctrl.h"

D irList2 的操作基本上与 D irList1 相同，除了 CPagel 类包括了一个叫作CheckDateSize 的新成员函数之外， CheckDateSize 是一个通过调用CDirListCtrl::SetCallBack 进行注册的回调函数。正如在源代码的注解中所说明的那样， CDirListCtrl::findFiles 为它想添加到目录列表的每个文件名调用这个回调函数，为该回调函数分配一个指向 W IN32_FIND_FILE 结构的指针，该结构包含

有与该文件有关的信息。 CheckDateSize 用于决定文件确认用户在 Size 和 Date

页中所设置的过滤器，并返回一个值 TRUE 或 FALSE ，允许或不允许该文件。

修改后的源代码列在下面。没有包括 D irList.rc 和 Resoure.h 文件，原因是它们与第 5 章中的只有细微的差别，只是融入了代表图标资源 IDI_FLOPPY, IDI_HARDISK, IDI_CD-ROM 和 IDI_FOLDER 的几行，因为程序在没有目标标记的列表中留下了文件名，所以没有定义 IDI_FILE 。你可以在本书配套光盘的Code\Chapter.07\DirList2 子文件夹中找到所有的文件。

列表 7-2 用于 DirList1 程序的源文件

class CDirListApp : public CWinApp

{

public:

BOOL InitInstance ();

};

class CAboutDlg : public CDialog

{

public:

CAboutDlg();

};

class CPage2; // Forward reference

class CPage3;

///////////////////////////////////////////////////////////////////////

// CPage1 property page

class CPage1 : public CPropertyPage

{

private:

BOOL bEditChange;

CDirListCtrl dirlist;

CString strFilter, strOldFilter;

static CPage2* pDate;

static CPage3* pSize;

static BOOL CALLBACK CheckDateSize( PWIN32_FIND_DATA pfd );

public:

CPage1 () : CPropertyPage( IDD_PAGE1 ) {}

protected:

virtual void DoDataExchange( CDataExchange* pDX );

virtual BOOL OnInitDialog ();

virtual BOOL OnSetActive ();

afx_msg void OnUp1Level ();

afx_msg void OnEditGainFocus ();

afx_msg void OnEditChanging ();

afx_msg void OnEditLoseFocus ();

DECLARE_MESSAGE_MAP ()

};

////////////////////////////////////////////////////////////////////////////////////////////////////

// CPage2 property page

class CPage2 : public CPropertyPage

{

public:

int nAnyDate, PrevDays, PrevMonths;

Ctime timeMin, timeMax;

CPage2 () : CPropertyPage( IDD_PAGE2 ) {}

protected:

virtual void DoDataExchange( CDataExchange* pDX );

virtual BOOL OnInitDialog ();

};

///////////////////////////////////////////////////////////////////////

// CPage3 property page

class CPage3 : public CPropertyPage

{

public:

int nAnySize;

DWORD MinSize, MaxSize;

CPage3 () : CPropertyPage( IDD_PAGE3 ) {}

protected:

virtual void DoDataExchange( CDataExchange* pDX );

virtual BOOL OnInitDialog ();

};

///////////////////////////////////////////////////////////////////////

// CListSheet

class CListSheet : public CPropertySheet

{

public:

CPage1 page1;

CPage2 page2;

CPage3 page3;

CListSheet( LPCTSTR szCaption );

protected:

virtual BOOL OnInitDialog();

afx_msg void OnSysCommand( UINT nID, LPARAM lParam );

DECLARE_MESSAGE_MAP()

};

DisList2.cpp

// ********************************************************************

// DirList2.cpp

// ********************************************************************

#include "afxwin.h"

#include "afxdlgs.h"

#include "afxcmn.h"

#include "resource.h"

#include "dirctrl.h"

#include "dirlist2.h"

CDirListApp DirListApp;

BOOL CDirListApp::InitInstance ()

{

CListSheet sh( "Directory List" ); // Create property sheet object

sh.DoModal (); // and display dialog

return FALSE; // Return FALSE to exit DirList2

}

CAboutDlg::CAboutDlg() : CDialog( IDD_ABOUTBOX )

{

}

/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

// CListSheet property sheet

CListSheet::CListSheet( LPCTSTR szCaption ) :

CPropertySheet( szCaption )

{

AddPage( &page1 );

AddPage( &page2 );

AddPage( &page3 );

}

BEGIN_MESSAGE_MAP (CListSheet, CPropertySheet)

ON_WM_SYSCOMMAND()

END_MESSAGE_MAP()

BOOL CListSheet::OnInitDialog()

{

CButton* button;

CPropertySheet::OnInitDialog();

// Add "About..." menu item to system menu

CMenu* pSysMenu = GetSystemMenu( FALSE );

CString str;

str.LoadString( IDD_ABOUTBOX );

pSysMenu->AppendMenu( MF_SEPARATOR );

pSysMenu->AppendMenu( MF_STRING, IDD_ABOUTBOX, str );

// Remove Apply and Cancel buttons and rename OK button

button = (CButton *) GetDlgItem( ID_APPLY_NOW );

button->DestroyWindow();

button = (CButton *) GetDlgItem( IDCANCEL );

button->DestroyWindow();

button = (CButton *) GetDlgItem( IDOK );

button->SetWindowText( "Close" );

// Set the 16-by-16 image (see closing remarks in Chapter 5)

HICON hIcon = (HICON) ::LoadImage( DirListApp.m_hInstance,

MAKEINTRESOURCE( IDI_APPICON ),

IMAGE_ICON, 16, 16, LR_DEFAULTCOLOR );

SetIcon( hIcon, FALSE );

// Activate OnInitDialog for each page to init member variables

SetActivePage( 2 );

SetActivePage( 1 );

SetActivePage( 0 );

return TRUE;

}

void CListSheet::OnSysCommand( UINT nID, LPARAM lParam )

{

if (nID == IDD_ABOUTBOX)

{

CAboutDlg dlgAbout;

dlgAbout.DoModal();

}

else

{

CPropertySheet::OnSysCommand( nID, lParam );

}

////////////////////////////////////////////////////////////////////////////////////////////////////////////////

// CPage1 property page

CPage2* CPage1::pDate; // Static ptrs to Date and

CPage3* CPage1::pSize; // Size property pages

BOOL CPage1::OnInitDialog ()

{

RECT rect = { 15, 60, 390, 102 }; // Dimensions of DirCtrl ctrl

strFilter = "*.*";

bEditChange = FALSE;

pDate = (CPage2*) ((CListSheet*) GetParent())->GetPage( 1 );

pSize = (CPage3*) ((CListSheet*) GetParent())->GetPage( 2 );

dirlist.Create( this, &rect, IDC_DIRCTRL, IDC_DIRPATH, DL_ALL, IDI_FLOPPY );

dirlist.SetCallBack( &CheckDateSize );

return CDialog::OnInitDialog ();

}

BOOL CPage1::OnSetActive ()

{

dirlist.ShowList( strFilter );

return CPropertyPage::OnSetActive ();

}

BEGIN_MESSAGE_MAP ( CPage1, CPropertyPage )

ON_EN_SETFOCUS ( IDC_EDIT1, OnEditGainFocus )

ON_EN_CHANGE ( IDC_EDIT1, OnEditChanging )

ON_EN_KILLFOCUS ( IDC_EDIT1, OnEditLoseFocus )

ON_BN_CLICKED ( IDC_BUTTON1, OnUp1Level )

END_MESSAGE_MAP ()

// These three functions simply ensure that when the user types in another

// filter string (such as "*.txt"), the directory listing is automatically

// updated to reflect the change.

//

void CPage1::OnEditGainFocus ()

{

GetDlgItemText( IDC_EDIT1, strOldFilter );

}

void CPage1::OnEditChanging ()

{

bEditChange = TRUE;

}

void CPage1::OnEditLoseFocus ()

{

if (bEditChange)

{

bEditChange = FALSE;

UpdateData( TRUE );

// If user enters a new filter string, update the directory list

if (strFilter != strOldFilter)

{

dirlist.ShowList( strFilter );

strOldFilter = strFilter;

}

void CPage1::OnUp1Level ()

{

CString strPath;

// If Enter pressed in edit control, refresh list

if (GetFocus() == GetDlgItem( IDC_EDIT1 ))

OnEditLoseFocus ();

// Else go up one directory level

else

{

dirlist.GetPath( strPath );

// When strPath == "d:\", we're already at root

if (strPath.Right( 2 ) != ":\\")

{

// Remove '\' at end of string

strPath.GetBufferSetLength( strPath.GetLength() - 1 );

strPath.ReleaseBuffer ();

// Find last '\' and truncate strPath string

int cLastSlash = strPath.ReverseFind( '\\' );

if (cLastSlash != -1)

{

strPath.GetBufferSetLength( cLastSlash + 1 );

strPath.ReleaseBuffer ();

dirlist.SetPath( strPath );

dirlist.ShowList( strFilter );

}

// Each time it finds a file that is a candidate for inclusion in the

// directory list, CDirListCtrl::FindFiles calls this static callback

//

BOOL CPage1::CheckDateSize( PWIN32_FIND_DATA pfd )

{

// Accept all subdirectories regardless of date/size criteria

if (pfd->dwFileAttributes & FILE_ATTRIBUTE_DIRECTORY)

return TRUE;

// If options set in Date page, filter files by date criteria

if (pDate->nAnyDate)

{

CTime timeFile( pfd->ftLastWriteTime );

if (pDate->nAnyDate == 1)

{

// Reject file not dated within specified min/max period

if (timeFile <= pDate->timeMin || timeFile > pDate->timeMax)

return FALSE;

}

else

{

CTime timeNow = CTime::GetCurrentTime();

CTimeSpan timeAge( timeNow.GetTime() - timeFile.GetTime() );

// Reject file older than specified number of months

if (pDate->nAnyDate == 2 && pDate->PrevMonths)

if (timeAge.GetDays()/30 >= pDate->PrevMonths)

return FALSE;

// Reject file older than specified number of days

if (pDate->nAnyDate == 3 && pDate->PrevDays)

if (timeAge.GetDays() >= pDate->PrevDays)

return FALSE;

}

// If options set in Size page, filter files by size criteria

if (pSize->nAnySize)

{

if (pSize->MinSize && pfd->nFileSizeLow < pSize->MinSize*1024)

return FALSE;

if (pSize->MaxSize && pfd->nFileSizeLow > pSize->MaxSize*1024)

return FALSE;

}

return TRUE;

}

void CPage1::DoDataExchange( CDataExchange* pDX )

{

CPropertyPage::DoDataExchange( pDX );

DDX_Text( pDX, IDC_EDIT1, strFilter );

DDV_MaxChars( pDX, strFilter, 128 );

}

///////////////////////////////////////////////////////////////////////

// CPage2 property page

BOOL CPage2::OnInitDialog ()

{

CSpinButtonCtrl* spin;

// Initialize variables

nAnyDate = 0;

PrevDays = 1;

PrevMonths = 1;

timeMin = 0;

timeMax = CTime::GetCurrentTime();

// Set limits of spin buttons

spin = (CSpinButtonCtrl *) GetDlgItem( IDC_SPIN1 );

spin->SetRange( 1, 100 ); // Within x months

spin = (CSpinButtonCtrl *) GetDlgItem( IDC_SPIN2 );

spin->SetRange( 1, 365 ); // Within x days

return CDialog::OnInitDialog ();

}

void CPage2::DoDataExchange( CDataExchange* pDX )

{

CPropertyPage::DoDataExchange( pDX );

DDX_DateTimeCtrl( pDX, IDC_DATETIME1, timeMin);

DDX_DateTimeCtrl( pDX, IDC_DATETIME2, timeMax);

DDX_Radio( pDX, IDC_RADIO1, nAnyDate );

DDX_Text( pDX, IDC_EDIT1, PrevMonths );

DDX_Text( pDX, IDC_EDIT2, PrevDays );

}

///////////////////////////////////////////////////////////////////////////////////////////////////////

// CPage3 property page

BOOL CPage3::OnInitDialog ()

{

CSpinButtonCtrl* spin;

// Initialize variables

nAnySize = 0;

MinSize = 0;

MaxSize = 100;

// Set limits of spin buttons

spin = (CSpinButtonCtrl *) GetDlgItem( IDC_SPIN1 );

spin->SetRange( 0, 9999 ); // Min size

spin = (CSpinButtonCtrl *) GetDlgItem( IDC_SPIN2 );

spin->SetRange( 1, 9999 ); // Max size

return CDialog::OnInitDialog ();

}

void CPage3::DoDataExchange( CDataExchange* pDX )

{

CPropertyPage::DoDataExchange( pDX );

DDX_Radio( pDX, IDC_RADIO1, nAnySize );

第 三 部 分 编 程 帮 助 工 具

第 三 部 分 编 程 帮 助 工 具

第 6 章 C lass W izard （ 类 向 导 ）

访 问 ClassWizard

ClassWizard 对 话

表 6-1 MFC C lass W izard 对 话 框 的 五 个 选 项 卡选 项 卡 用 途

Message Maps （ 消 息 映 射 ） 选 项 卡

表 6-2 在 Message Map 选 项 卡 中 ， Object Ids 框 中 的 选 中 部 分 决 定 了 Message

Object IDS 框 中 选中 部 分

Member Variables （ 成 员 变 量 ） 选 项 卡

表 6-3 用 于 标 准 控 件 的 Value 和 Control 类 别 的 变 量 类 型

据 类 型

表 6-4 常 见 的 对 话 数 据 交 换 函 数

… 用 于 该 种 类 型 控件

向 项 目 添 加 类

W izardBa r（ 向 导 栏 ）

表 6-6 W izardBar 上 的 控 件

ClassWizard 如 何 识 别 类

表 6-7 ClassWizard 所 需 要 的 注 释 关 键 字

用 ClassWizard 创 建 对 话 类

第 7 章 Ga llery （ 组 件 集 ）

例 子 ： 添 加 一 个 属 性 表

例 子 : 添 加 初 始 屏 幕 和 时 钟

创 建 自 定 义 的 组 件

例 子 ： 用 于 目 录 列 表 的 自 定 义 组 件

表 7-1 CDirListCtrl 类 的 源 文 件

表 7-1 Create 函 数 的 参 数

例 子 :D irList2 程 序

//

//

第三部分编程帮助工具

第三部分编程帮助工具

第 6 章 C lass W izard （类向导）

访问 ClassWizard

ClassWizard 对话

表 6-1 MFC C lass W izard 对话框的五个选项卡选项卡用途

Message Maps （消息映射）选项卡

表 6-2 在 Message Map 选项卡中， Object Ids 框中的选中部分决定了 Message

Object IDS 框中选中部分

Member Variables （成员变量）选项卡

表 6-3 用于标准控件的 Value 和 Control 类别的变量类型

据类型

表 6-4 常见的对话数据交换函数

… 用于该种类型控件

向项目添加类

W izardBa r（向导栏）

表 6-6 W izardBar 上的控件

ClassWizard 如何识别类

表 6-7 ClassWizard 所需要的注释关键字

用 ClassWizard 创建对话类

第 7 章 Ga llery （组件集）

例子：添加一个属性表

例子 : 添加初始屏幕和时钟

创建自定义的组件

例子：用于目录列表的自定义组件

表 7-1 CDirListCtrl 类的源文件

表 7-1 Create 函数的参数

例子 :D irList2 程序