MFC之向导页和属性页(CPropertyPage/CPropertySheet)

Posted 2020-11-27 emjx

(Mark) : 类CPropertyPage的对象表示一张属性表的各页，或者说是被看作是标签对话框 - 摘自百度百科

(Mark) :CPropertyPage 是继承自CWnd的子类。

(Mark) :以下是类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”按钮被单击的消息，仅在向导对话框中有效

 

CPropertySheet 属性表类 继承自CWnd

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：要删除的属性页的索引

 

图示演示一个演示(向导页)：

1 创建一个MFC 对话框应用程序

2 插入两个Dialog资源

 

 

ID分别是：IDD_PAGE1,IDD_PAGE2

3 为两个Dialog新建一个CPropertyPage类对象

 

 

 

 注意基类选择:CPropertyPage

4 在类向导中新建一个继承自CPropertySheet的子类，如CMySheet

 

 5 在CMySheet头文件中引入属性页的头文件，并分别定义两个成员对象。

 

 

 

 6 在CMySheet类的实现文件中的CMySheet属性表构造函数中关联两个属性页。

 

 7 在Dialog的Dlg类实现文件中引入CMySheet类头文件和在主Dialog新增一个button，并添加click事件。在事件处理函数中，创建CMySheet对象并设置向导模式和显示向导属性页

 

Mark ：

向导属性页和一般属性页的区别只是SetWizardMode() 函数。不调用此函数则显示的是：