MFC之向导页和属性页(CPropertyPage/CPropertySheet)
(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() 函数。不调用此函数则显示的是: