MFC---属性页、向导对话框和一般属性页对话框（对话框）(类视图中进行重载)

前面讲了模态对话框和非模态对话框，本节开始讲一种特殊的对话框–属性页对话框。另外，本套教程所讲大部分对VC++各个版本均可适用或者稍作修改即可。

属性页对话框的分类

属性页对话框想必大家并不陌生，XP系统中桌面右键点属性，弹出的就是属性页对话框，它通过标签切换各个页面。另外，我们在创建MFC工程时使用的向导对话框也属于属性页对话框，它通过点击“Next”等按钮来切换页面。

属性页对话框就是包含一般属性页对话框和向导对话框两类。它将多个对话框集成于一身，通过标签或按钮来切换页面。

属性页对话框相关类

我们使用属性页对话框时，用到的类主要有两个：CPropertyPage类和CPropertySheet类。

1.CPropertyPage类

CPropertyPage类继承自CDialog类，它被用于处理某单个的属性页，所以要为每个属性页都创建一个继承自CPropertyPage的子类。大家可以在VS2010的MSDN中查找CPropertyPage类以及它的成员的详细说明。下面就为大家讲解MSDN中列出的CPropertyPage类的部分主要成员函数。

（1）构造函数

这里讲三个CProperty类的构造函数，函数原型为：

CPropertyPage( );
explicit CPropertyPage(
        UINT nIDTemplate,
        UINT nIDCaption = 0,
        DWORD dwSize = sizeof(PROPSHEETPAGE)
);
explicit CPropertyPage(
        LPCTSTR lpszTemplateName,
        UINT nIDCaption = 0,
        DWORD dwSize = sizeof(PROPSHEETPAGE)
);

第一个是没有任何参数的构造函数。

第二个构造函数中，参数nIDTemplate是属性页的对话框资源ID，参数nIDCaption是属性页对话框选项卡的标题所用字符串资源的ID，若设为0，则选项卡标题就使用该属性页的对话框资源的标题。

第三个构造函数中，参数lpszTemplateName为属性页的对话框资源的名称字符串，不能为NULL。参数nIDCaption同上。

（2）CancelToClose()函数

在模态属性页对话框的属性页进行了某不可恢复的操作后，使用CancelToClose()函数将“OK”按钮改为“Close”按钮，并禁用“Cancel”按钮。函数原型为：

void CancelToClose( );

（3）SetModified()函数

调用此函数可激活或禁用“Apply”按钮，函数原型为：

void SetModified(BOOL bChanged = TRUE);

（4）可重载函数

CPropertyPage类提供了一些消息处理函数，来响应属性页对话框的各种消息。我们重载这些消息处理函数，就可以自定义对属性页对话框操作的处理。可重载的消息处理函数包括：

OnApply：处理属性页的“Apply”按钮被单击的消息
       OnCancel：处理属性页的“Cancel”按钮被单击的消息
       OnKillActive：处理属性页当前活动状态被切换的消息，常用于数据验证
       OnOK：处理属性页的“OK”按钮、“Apply”按钮或者“Close”按钮被单击的消息
       OnQueryCancel：处理属性页的“Cancel”按钮被单击前发出的消息
       OnReset：处理属性页的“Reset”按钮被单击的消息
       OnSetActive：处理属性页被切换为当前活动页的消息
       OnWizardBack：处理属性页的“Back”按钮被单击的消息，仅在向导对话框中有效
       OnWizardFinish：处理属性页的“Finish”按钮被单击的消息，仅在向导对话框中有效
       OnWizardNext：处理属性页的“Next”按钮被单击的消息，仅在向导对话框中有效

2.CPropertySheet类

CPropertySheet类继承自CWnd类，它是属性表类，负责加载、打开或删除属性页，并可以在属性页对话框中切换属性页。它跟对话框类似，也有模态和非模态两种。下面就讲解CPropertySheet类的部分成员函数。
（1）构造函数
这里依然列出CPropertySheet类的三个构造函数：

CPropertySheet( );
   explicit CPropertySheet(
           UINT nIDCaption,
           CWnd* pParentWnd = NULL,
           UINT iSelectPage = 0 
   );
   explicit CPropertySheet(
           LPCTSTR pszCaption,
           CWnd* pParentWnd = NULL,
           UINT iSelectPage = 0 
   );

参数nIDCaption：标题的字符串资源的ID。
参数pParentWnd：属性页对话框的父窗口，若设为NULL，则父窗口为应用程序的主窗口。
参数iSelectPage：初始状态时，活动属性页的索引，默认为第一个添加到属性表的属性页。
参数pszCaption：标题字符串。

（2）GetActiveIndex()函数

获取当前活动属性页的索引。函数原型为：

int GetActiveIndex( ) const;

返回值：当前活动属性页的索引。

（3）GetActivePage()函数

获取当前活动属性页对象。函数原型为：

CPropertyPage* GetActivePage( ) const;

返回值：当前活动属性页对象的指针。

（4）GetPage()函数
获取某个属性页对象。函数原型为：

CPropertyPage* GetPage(int nPage) const;

参数nPage：目标属性页的索引。
返回值：目标属性页对象的指针。

（5）GetPageCount()函数
获取属性页的数量。函数原型为：

int GetPageCount( ) const;

返回值：属性页的数量。

（6）GetPageIndex()函数
获取某属性页在属性页对话框中的索引。函数原型为：

int GetPageIndex(CPropertyPage* pPage);

参数pPage：要获取索引的属性页对象的指针。
返回值：属性页对象在属性页对话框中的索引。

（7）SetActivePage()函数
设置某个属性页为活动属性页。函数原型为：

BOOL SetActivePage(
                 int nPage 
       );
       BOOL SetActivePage(
                 CPropertyPage* pPage 
       );

参数nPage：要设置为活动属性页的索引。
参数pPage：要设置为活动属性页的对象指针。

（8）SetWizardButtons()函数
在向导对话框上启用或禁用Back、Next或Finish按钮，应在调用DoModal之前调用此函数。函数原型为：

void SetWizardButtons(
                DWORD dwFlags 
       );

参数dwFlags：设置向导按钮的外观和功能属性。可以是以下值的组合：“
PSWIZB_BACK 启用“Back”按钮，如果不包含此值则禁用“Back”按钮。
PSWIZB_NEXT 启用“Next”按钮，如果不包含此值则禁用“Next”按钮。
PSWIZB_FINISH 启用“Finish”按钮。
PSWIZB_DISABLEDFINISH 显示禁用的“Finish”按钮。
（9）SetWizardMode()函数
设置属性页对话框为向导对话框模式，应在调用DoModal之前调用此函数。函数原型为：

void SetWizardMode( );

（10）SetTitle()函数

设置属性对话框的标题。函数原型为：

void SetTitle(
               LPCTSTR lpszText,
               UINT nStyle = 0 
       );

参数lpszText：标题字符串。

参数nStyle：指定属性表标题的风格。应当为0或PSH_PROPTITLE。如果设为PSH_PROPTITLE，则单词“Properties”会出现在指定标题之后。例如，SetTitle(“Simple”,PSH_PROPTITLE)这种调用会使得属性表标题为“Simple Properties”。

（11）AddPage()函数
为属性对话框添加新的属性页。函数原型为：

void AddPage(
               CPropertyPage *pPage 
       );

参数pPage：要添加的新的属性页的对象指针。
（12）PressButton()函数
模拟按下某指定的按钮。函数原型为：

void PressButton(
               int nButton 
       );

参数nButton：要模拟按下的按钮，它可以是下列值之一：

PSBTN_BACK 选择“Back”按钮。
PSBTN_NEXT 选择“Next”按钮。
PSBTN_FINISH 选择“Finish”按钮。
PSBTN_OK 选择“OK”按钮。
PSBTN_APPLYNOW 选择“Apply”按钮。
PSBTN_CANCEL 选择“Cancel”按钮。
PSBTN_HELP 选择“帮助”按钮。

（13）RemovePage()函数
删除某属性页。函数原型为：

void RemovePage(
               CPropertyPage *pPage 
       );
       void RemovePage(
               int nPage 
       );

参数pPage：要删除的属性页的对象指针。
参数nPage：要删除的属性页的索引。

属性对话框和相关的两个类就先介绍到这，主要是为后面使用属性页对话框做准备。

上一讲讲了属性页对话框和相关的两个类CPropertyPage类和CPropertySheet类，对使用属性页对话框做准备。本节将为大家演示如何创建向导对话框。

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

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

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

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属性改为‘最后请按下“计算”按钮’，其他属性也第一个对话框一样。

2.创建属性页类

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

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

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

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

BOOL CSummandPage::OnSetActive()   
{   
    // TODO: Add your specialized code here and/or call the base class   
   
    // 获得父窗口，即属性表CPropertySheet类   
    CPropertySheet* psheet = (CPropertySheet*) GetParent();   
    // 设置属性表只有“下一步”按钮   
    psheet->SetWizardButtons(PSWIZB_NEXT);   
   
    return CPropertyPage::OnSetActive();   
}

为第二个和第三个对话框也分别添加属性页类CAddendPage和CAddPage。但第二个对话框的属性页不需要重载OnSetActive函数。第三个对话框是最后一个对话框，所以不需要“下一步”按钮，而应该换成“完成”按钮，所以也需要重载OnSetActive函数设置“完成”按钮。重载后的OnSetActive如下：

BOOL CAddPage::OnSetActive()   
{   
    // TODO: Add your specialized code here and/or call the base class   
   
    // 获得父窗口，即属性表CPropertySheet类   
    CPropertySheet* psheet = (CPropertySheet*) GetParent();   
    //设置属性表只有“完成”按钮   
    psheet->SetFinishText(_T("完成"));   
   
    return CPropertyPage::OnSetActive();   
}

上面的代码段中，字符串“完成”前加了个_T，这是因为本工程创建的时候用的默认的Unicode字符集，而如果“完成”前不加_T就是ASCII字符串。_T实际上是一个宏，工程的字符集选择为Unicode时字符串就转为Unicode字符串，选择为Muli-Byte时就转为ASCII字符串。

我们可以在Solution Explorer的Addition根节点上点右键，在右键菜单上选择“Properties”，弹出工程的属性对话框，Configuration Properties->General右侧列表中的Character Set就显示选择的字符集。

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

BOOL CAddPage::OnWizardFinish()   
{   
    // TODO: Add your specialized code here and/or call the base class   
   
    // 提示向导完成   
    MessageBox(_T("使用说明向导已阅读完！"));   
   
    return CPropertyPage::OnWizardFinish();   
}

3.创建属性表类

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

在Solution Explorer视图中的根节点“Addition”上点右键，在右键菜单中选择Add->Class，弹出“Add Class”对话框，然后在中间区域中选择“MFC Class”，点“Add”按钮，弹出另一个类向导对话框，设置Class name为CAddSheet，Base class选择“CPropertySheet”，点“Finish”按钮，这样就属性表类就建好了。

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

#include "SummandPage.h"
       #include "AddendPage.h"
       #include "AddPage.h"

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

CSummandPage    m_summandPage;
       CAddendPage     m_addendPage;
       CAddPage        m_addPage;

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

CAddSheet::CAddSheet(UINT nIDCaption, CWnd* pParentWnd, UINT iSelectPage)   
    :CPropertySheet(nIDCaption, pParentWnd, iSelectPage)   
{   
    // 添加三个属性页到属性表   
    AddPage(&m_summandPage);   
    AddPage(&m_addendPage);   
    AddPage(&m_addPage);   
}   
   
CAddSheet::CAddSheet(LPCTSTR pszCaption, CWnd* pParentWnd, UINT iSelectPage)   
    :CPropertySheet(pszCaption, pParentWnd, iSelectPage)   
{   
    // 添加三个属性页到属性表   
    AddPage(&m_summandPage);   
    AddPage(&m_addendPage);   
    AddPage(&m_addPage);   
}

4.显示向导对话框

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

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

void CAdditionDlg::OnBnClickedInstructButton()   
{   
    // TODO: Add your control notification handler code here   
   
    // 创建属性表对象   
    CAddSheet sheet(_T(""));   
    // 设置属性对话框为向导对话框   
    sheet.SetWizardMode();   
    // 打开模态向导对话框   
    sheet.DoModal();   
}

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

上图只是被加数页的效果，点其上“下一步”按钮就可以继续显示后面的两个页面。
是不是向导对话框没有以前想象的那般复杂了？大家可以发挥想象，进行更复杂的修改，实现更完善的功能。

属性页对话框包括向导对话框和一般属性页对话框两类，上一节讲了如何创建并显示向导对话框，本节将继续介绍一般属性页对话框的创建和显示。

实际上，一般属性页对话框的创建和显示过程和向导对话框是很类似的。将上一节中的向导对话框进行少量修改，使其成为一般属性页对话框。
一般属性页对话框的创建步骤：

1.创建属性页对话框资源

属性页对话框资源的创建方法同向导对话框是一样的，上一讲中的对话框资源不需进行任何修改。

2.创建属性页类

属性页类的创建和向导对话框的属性页类也基本一样，只是一般属性页对话框中不需要“下一步”和“完成”等按钮，所以上一讲中属性页类的OnSetActive和OnWizardFinish等重载函数可以去掉。即CSummandPage类中的OnSetActive函数、CAddPage类中的OnSetActive函数和OnWizardFinish函数可以删除或注释掉。其他部分不需作任何修改。

3.创建属性表类

创建属性表类的过程同向导对话框属性表类也是一样的，所以上一讲中的CAddSheet类不需修改。

4.显示一般属性页对话框

上一讲向导对话框的显示是在OnBnClickedInstructButton函数中实现的，其中语句sheet.SetWizardMode();旨在设置属性表为向导对话框模式，所以显示一般属性页对话框时不需调用SetWizardMode成员函数。另外，我们可以将属性页对话框的标题设为“使用说明”，在构造属性表对象时将此字符串作为构造函数的参数传入。OnBnClickedInstructButton函数修改如下：

void CAdditionDlg::OnBnClickedInstructButton()   
{   
    // TODO: Add your control notification handler code here   
   
    // 创建属性表对象   
    CAddSheet sheet(_T("使用说明"));   
        
    // 打开模态一般属性页对话框   
    sheet.DoModal();   
}

这样一般属性页对话框的创建和显示就讲完了，我们运行下程序，在结果对话框上点“使用说明”按钮看看效果吧：

再总结下，一般属性页对话框和向导对话框的创建和显示的不同包括，是否需要OnSetActive和OnWizardFinish等重载函数，是否需要调用属性表类的SetWizardMode函数设置为向导对话框模式。