【10】MFC入门到精通——MFC 创建向导对话框、属性页类、属性表类、代码

文章目录

十、创建向导对话框
- 10.1 创建属性页对话框资源
- 10.2 创建属性页类
- 10.3 创建属性表类
- 10.4 显示向导对话框
- 10.5 注意事项运行可能报错
- 10.6 完整代码下载

十、创建向导对话框

仍然以前面的"加法计算器"的例子为基础，在其中加入向导对话框，我们可以用它来说明加法计算器的使用方法，一步一步引导用户操作，这也是比较常见的用法。

加法计算器使用时大概可以分为三步：输入被加数、输入加数、点"计算"按钮。

就详细说明向导对话框的创建步骤：

10.1 创建属性页对话框资源

根据创建对话框模板和修改对话框属性中所讲方法，在"Resource View"的Dialog"节点上点右键，然后在右键菜单中选择"Insert Dialog"创建第一个对话框模板，对话框的ID属性设置为IDD_SUMMAND_PAGE，Caption属性改为"被加数页"，Style属性在下拉列表中选择"Child"，Border属性在下拉列表中选择"Thin"。

删除"OK"和"Cancel"按钮，再按照为对话框添加控件中所讲方法，添加一个静态文本框，并修改静态文本框的Caption属性为"请先输入double型被加数"。

按照上述步骤，继续添加第二个和第三个对话框资源。第二个对话框模板的ID设为IDD_ADDEND_PAGE，Caption属性改为"加数页"，也添加一个静态文本框，Caption设为"请继续输入double型加数"，其他属性同第一个对话框。第三个对话框模板的ID设为IDD_ADD_PAGE，Caption属性改为"计算页"，添加静态文本框的Caption属性改为"最后请按下"计算"按钮"，其他属性也第一个对话框一样。

10.2 创建属性页类

按照创建对话框类和添加控件变量中的方法，在第一个对话框模板上点右键，在右键菜单中选择"Add Class"，弹出类向导对话框，在"Class name"编辑框中输入类名"CSummandPage"，与之前不同的是，因为属性页类都应继承于CPropertyPage类，所以要修改下面"Base class"的选项，在下拉列表中选择"CPropertyPage"。

基类下来列表中没有CPropertyPage，只有CMFCPropertyPage 。那就选择CMFCPropertyPage。

cpp 复制代码

CMFCPropertySheet和CMFCPropertyPage都是vs08sp1以后引入的新类，扩充了已有的CPropertySheet和CPropertyPage这两个类。

因为是第一个属性页，所以它应该有一个"下一步"按钮，在哪里添加呢？ 上一讲CPropertyPage类的可重载函数中提到，OnSetActive函数用于处理属性页被切换为当前活动页的消息，所以我们可以在OnSetActive函数中进行相关设置。

那怎样重载OnSetActive函数呢？ 我们可以在"Class View"中找到"CSummandPage"节点，点右键弹出右键菜单，选择"Properties"，然后VS右侧面板上会显示对话框的属性列表，属性列表的工具栏上有个tip信息为 "Overrides" （重载） 的按钮，按下它，下方列表中就列出了重载函数，找到"OnSetActive"，点其右侧空白列表项出现向下箭头，再点箭头就在下面出现了"OnSetActive"的选项，选择它就会自动在CSummandPage类中添加函数OnSetActive。

我们只需在OnSetActive函数体中添加相关代码就可以实现添加"下一步"按钮的效果了。新的函数体如下：

cpp 复制代码

BOOL CSummandPage::OnSetActive()
{
	// TODO: 在此添加专用代码和/或调用基类

	// 获得父窗口，即属性表CPropertySheet类
	CMFCPropertySheet* psheet = (CMFCPropertySheet*)GetParent();

	// 设置属性表只有"下一步"按钮
	psheet->SetWizardButtons(PSWIZB_NEXT);

	return CMFCPropertyPage::OnSetActive();
}

为第二个和第三个对话框也分别添加属性页类CAddendPage和CAddPage。

基类下来列表中没有CPropertyPage，只有CMFCPropertyPage 。那就选择CMFCPropertyPage。

cpp 复制代码

CMFCPropertySheet和CMFCPropertyPage都是vs08sp1以后引入的新类，扩充了已有的CPropertySheet和CPropertyPage这两个类。

第二个对话框的属性页不需要重载OnSetActive函数。

第三个对话框是最后一个对话框，所以不需要"下一步"按钮，而应该换成"完成"按钮，所以也需要重载OnSetActive函数设置"完成"按钮。重载后的OnSetActive如下：

cpp 复制代码

BOOL CAddPage::OnSetActive()
{
	// TODO: 在此添加专用代码和/或调用基类

	// 获得父窗口，即属性表CPropertySheet类
	CMFCPropertySheet* psheet = (CMFCPropertySheet*)GetParent();

	//设置属性表只有"完成"按钮
	psheet->SetFinishText(_T("完成"));

	return CMFCPropertyPage::OnSetActive();
}

上面的代码段中，字符串"完成"前加了个_T，这是因为本工程创建的时候用的默认的Unicode字符集，而如果"完成"前不加_T就是ASCII字符串。_T实际上是一个宏，工程的字符集选择为Unicode时字符串就转为Unicode字符串，选择为Muli-Byte时就转为ASCII字符串。我们可以在Solution Explorer的Addition根节点上点右键，在右键菜单上选择"Properties"，弹出工程的属性对话框，Configuration Properties->General右侧列表中的Character Set就显示选择的字符集。

那点了第三个属性页上的"完成"按钮我们想进行某些处理的话，就重载OnWizardFinish函数，方法同OnSetActive函数。重载后的OnWizardFinish函数如下：

cpp 复制代码

BOOL CAddPage::OnWizardFinish()
{
	// TODO: 在此添加专用代码和/或调用基类

	// 提示向导完成
	MessageBox(_T("使用说明向导已阅读完！"));
	
	return CMFCPropertyPage::OnWizardFinish();
}

10.3 创建属性表类

属性页资源和属性页类创建完以后，还不能生成向导对话框，我们还需要一个属性表类，来容纳这些属性页。

在Solution Explorer视图中的根节点"Addition"上点右键，在右键菜单中选择类向导->添加类,选择"MFC Class"，弹出对话框，设置Class name为CAddSheet，Base class选择"CMFCPropertySheet"，点"Finish"按钮，这样就属性表类就建好了。

接下来，在新生成的AddSheet.h中包含三个属性页类的头文件：

cpp 复制代码

#include "CSummandPage.h"
#include "CAddendPage.h"
#include "CAddPage.h"

之后在AddSheet.h中添加private变量：

给三个页类实例化对象；

cpp 复制代码

private:
	CSummandPage m_summandPage; 
	CAddendPage m_addendPage;
	CAddPage m_addPage;

然后在AddSheet.cpp文件中修改CAddSheet的两个构造函数为：

cpp 复制代码

CAddSheet::CAddSheet()
{
	// 添加三个属性页到属性表

	AddPage(&m_summandPage);//这里的AddPage()是系统头文件afxpropertysheet.h，不是我们创建的CAddPage

	AddPage(&m_addendPage);
				
	AddPage(&m_addPage);
}

CAddSheet::~CAddSheet()
{
	// 添加三个属性页到属性表

	AddPage(&m_summandPage);

	AddPage(&m_addendPage);

	AddPage(&m_addPage);
}

10.4 显示向导对话框

我们在加法计算器对话框上添加一个按钮，点击它就打开向导对话框。此按钮的ID设为IDC_INSTRUCT_BUTTON，Caption属性设为"使用说明"。

按照为控件添加消息处理函数中所讲方法，为IDC_INSTRUCT_BUTTON按钮在CAdditionDlg类中添加点击消息的处理函数OnBnClickedInstructButton。然后在AdditionDlg.cpp文件中包含CAddSheet的头文件：#include "AddSheet.h"。最后修改OnBnClickedInstructButton函数如下：

cpp 复制代码

void CAdditionDlg::OnBnClickedInstructButton()
{
	// TODO: 在此添加控件通知处理程序代码
	
	// 创建属性表对象
	CAddSheet sheet;//CAddSheet sheet(_T(""));

	// 设置属性对话框为向导对话框
	sheet.SetWizardMode();

	// 打开模态向导对话框
	sheet.DoModal();
}

到此，向导对话框就完整的创建完成了，并可以在加法计算器对话框上点 "使用说明" 按钮显示出来。我们来看看效果吧：