用VC++创建自定义向导程序

如需下载程序，请点击这里http://download.csdn.net/detail/s1915/8334091

向导是一种用来简化用户操作的程序。在Microsoft 的所有产品中都存在向导，如Office2000 中的Web 页向导就是一个十分典型的向 导（如下图所示），还有常用的VC++向导。

一个基本的向导程序应该包含以下几个基本按钮： 取消、上一步、下一步、完成、帮助

 一、标准向导程序

在 VC++中，可以使用类CPropertySheet和类CPropertyPage方便地编写一个向导程序。

首先我们来介绍一下类CPropertySheet 和类CPropertyPage。

1. 类CPropertyPage 是从CDiaglog中派生出来的，具有Diaglog的基本性质，需要注意的是它的样式必须是Child。

2. 类CPropertySheet 是一个属性表，也是一个窗体，相当一个容器，用来存放所有的CpropertyPage。它不是 从CDialog 派生出来的，但是它可以象普通对话框类似的操作， 如DoModal（），当用 DoModal（）显示 后，它就包含了“取消”、“上一步”、“下一步” 等基本按钮。

下面给出一个实例

① 新建一个 VC++ MFC AppWizard 工程，命名为TraditionalWizard，并选择Dialog Based 样式。

② 在自动生成 的Dialog 资源中加入一个按钮IDC_BENGINWIZ 用来启动向导。

③ 创建 CPropertyPage。新建Dialog 资源，命名为IDD_STEP1，注意一定要将新建对话框的Style属性设置成Child 和边界属性设置为Thin，并且不要生成一个新类。

用ClassWizard 生成一个新类，命名为CStep1，基类为CPropertyPage，且将Dialog ID 设置为刚生成的资源IDD_STEP1。这样就生成了一个新属性页Step1。如此操作就可以 同样生成Step2、Step3 属性页。为了方便显示，在每个对话框都放置了一个控件，用来表示当前是哪一步。

④ 创建 CPropertySheet。新建一个类，命名为CWizard，基类为CPropertySheet。并将属性页和属性表关联起来。代码为

01.//将代码放在按钮IDC_BEGINWIZ的Click事件中

02.CWizard MyWizard(_T("我的向导 "),this,1); //生成一个属性表

03.CStep1 MyStep1;  //属性页1

04.CStep2 MyStep2; //属性页2

05.CStep3 MyStep3; //属性页3

06.MyWizard.AddPage(&MyStep1); //添加属性页1

07.MyWizard.AddPage(&MyStep2); //添加属性页2

08.MyWizard.AddPage(&MyStep3); //添加属性页3

09.MyWizard.SetWizardMode();   //将属性表设置成向导样式

10.MyWizard.SetActivePage(&MyStep1); //设置第一页为第一步

11.MyWizard.DoModal(); //显示属性表

⑤协调显示。在每一页为当前页时，都会触发OnSetActive事件，故对每一个属性页都要重载该函数，在CStep1类上选择Add Virtual Function ...。因为显示第一页时，不存在“上一步”，故在CStep1的 OnSetActive函数中需要添加如下代码：

1.//代码放在OnSetActive函数中

2.CPropertySheet* pParent=(CPropertySheet*)GetParent(); // 获得属性表的指针

3.pParent->SetWizardButtons(PSWIZB_NEXT); // 设置属性表的显示按钮只为下一步

4.SetDlgItemText(IDC_TEXT1,"这是向导的第一步");

同样在显示中间页时应该设置成即有“上一步”，也有“下一步”，代码为:

1.CPropertySheet* pParent=(CPropertySheet*)GetParent();

2.pParent->SetWizardButtons(PSWIZB_NEXT|PSWIZB_BACK); 

3.SetDlgItemText(IDC_TEXT2,"这是向导的第二步");

最后在显示最后一页时只显示“完成”和“上一步”，代码为:

1.CPropertySheet* pParent=(CPropertySheet*)GetParent();

2.pParent->SetWizardButtons(PSWIZB_FINISH|PSWIZB_BACK);

3.SetDlgItemText(IDC_TEXT3,"这是向导的第三步");

这样一个基本的向导程序就完成了，其效果如图所示

二、自定义向导程序

通过上面的例子，我们不难发现标准的向导基本能满足要求，但仍然存在一些缺陷：

1.不能改变向导按钮的样式，如想在“上一步”、“下一步就”按钮上添加图标

2.不能象上面的Web向导一样有个“完成”按钮进行默认设置

3.不能修改向导按钮的位置

上述缺陷是因为我们采用了CPropertySheet类，而CPropertySheet类不是一个可修改的资源。

为了达到个性化向导的目的，我们可以不使用CPropertySheet类和CPropertyPage类。

设计的基本思路：

1． 采用标准的向导的工作方式。每一步就是一个对话框，向导本身也是一个对话框，用来容纳每步对话框.

2． 每步的对话框应 该没有Title、没有边界、样式为Child，当点击“下一步”或“上一步”时，将这个 对话框定位到要显示的位置。

3． 因为向导一般都包含很多步，为了管理这些页，我们可以创建一个链表来管理每一步的对话框。

4． 为了方便对话框定位，可以事先定义好位置。

三、自定义向导的实现

1． 工程的建立与基本界面的生成

生成一个MFC APPWIZARD 新工程，命名为CustomWizard,在Step1 中选择基于Dialog Based样式。

在自动生成的Dialog 资源中加入一个按钮IDC_BENGINWIZ 用来启动向导。

新建一个对话框 资源，命名为IDC_WIZARD，用来显示自定义向导界面，如图

 

依次创建向导的每页 的对话框资源，命名为IDD_STEP1,IDD_STEP2,IDD_STEP3,

（图4）

2． 生成所需要的类

为了方便叙述，表1将所用的类进行了归纳

（表1）

类名基类说明CWizardCDialog向导的框架CStep1CDialog向导的第一步CStep2CDialog向导的第二步CStep3CDialog向导的第三步CCustomWizardDlgCDialog启动向导

3. 在CWizard添加要使用的数据结构

为了方便描述，表2列出了使用到的成员变量

（表2）

成员变量类型说明rectPageCRect每页显示的范围nPageCountUINT页的总数nCurrentPageUINT正在显示的页nPageLinkPAGELINK*用来链接所有的页typedef struct PAGELINK{
UINT nNum;
CDialog* pDialog;
struct PAGELINK* Next;};nNum为页的编号
pDialog为页所对应的对话框的指针

4. CWizard所使用到的函数 添加一个新页到Wizard框架，入口参数为要添加的对话框指针和ID

01.void CWizard::AddPage(CDialog* pDialog, UINT nID)

02.{

03.struct PAGELINK* pTemp = pPageLink;

04.//插入新生成的结点

05.struct PAGELINK* pNewPage = new PAGELINK;

06.pNewPage->pDialog = pDialog;

07.pNewPage->pDialog->Create(nID,this); // 以无模式创建窗口

08. 

09.ASSERT(::IsWindow(pNewPage->pDialog->m_hWnd));

10.// 检查每页的样式

11.DWORD dwStyle = pNewPage->pDialog->GetStyle();

12.ASSERT((dwStyle & WS_CHILD) != 0); // 子窗口

13.ASSERT((dwStyle & WS_BORDER) == 0); // 无边界

14.// 显示

15.pNewPage->pDialog->ShowWindow(SW_HIDE); //先隐藏，需要时再显示

16.pNewPage->pDialog->MoveWindow(rectPage);

17.//移动对话框到制定位置，rectPage已经初始化了

18.pNewPage->Next=NULL;

19.pNewPage->nNum=++nPageCount; //计数器加1

20.if (pTemp)  //插入到链表

21.{ //如果不是空链表

22.while (pTemp->Next) pTemp=pTemp->Next; // 移动链表末尾

23.pTemp->Next=pNewPage;

24.}

25.else  // 空链表

26.pPageLink=pNewPage;  //若是第一个节点

27.}

显示的页,入口参数为要显示的某特定页的编码

01.void CWizard::ShowPage(UINT nPos)

02.{

03.struct PAGELINK* pTemp=pPageLink;

04.while(pTemp)

05.{

06.if(pTemp->nNum==nPos)

07.{

08.pTemp->pDialog->ShowWindow(SW_SHOW);

09.}

10.else

11.//不显示

12.pTemp->pDialog->ShowWindow(SW_HIDE);

13.pTemp=pTemp->Next;

14.}

15.if (nPos>=nPageCount)  //最后一页

16.{

17.nCurrentPage=nPageCount;

18.SetWizButton(2);

19.return;

20.}

21.if (nPos<=1) //首页

22.{

23.nCurrentPage=1;

24.SetWizButton(0);

25.return;

26.}

27.//如果是中间步

28.SetWizButton(1);

29.}

为了与显示统一，需要相应的设置按钮

01.void CWizard::SetWizButton(UINT uFlag)

02.{

03.GetDlgItem(IDC_CANCEL)->EnableWindow(TRUE);

04.GetDlgItem(IDC_PREV)->EnableWindow(TRUE);

05.GetDlgItem(IDC_NEXT)->EnableWindow(TRUE);

06.GetDlgItem(IDC_FINISH)->EnableWindow(TRUE);

07.switch(uFlag)

08.{

09.case 0: //第一步

10.GetDlgItem(IDC_PREV)->EnableWindow(FALSE);

11.break;

12.case 1: //中间步

13.break;

14.case 2: //最后一步

15.GetDlgItem(IDC_NEXT)->EnableWindow(FALSE);

16.break;

17.}

18.}

点击“上一步”、“下一步”、“完成”、“取消”代码

01.void CWizard::OnPrev() 

02.{

03.// TODO: Add your control notification handler code here

04.ShowPage(--nCurrentPage);

05.}

06.void CWizard::OnNext() 

07.{

08.// TODO: Add your control notification handler code here

09.ShowPage(++nCurrentPage);

10.}

11.void CWizard::OnFinish() 

12.{

13.// TODO: Add your control notification handler code here

14.AfxMessageBox("采用默认值完成向导");

15.CDialog::OnOK();

16.}

17.void CWizard::OnCancel() 

18.{

19.// TODO: Add your control notification handler code here

20.if (AfxMessageBox(IDS_QUIT,MB_OKCANCEL|MB_ICONQUESTION)==IDCANCEL)

21.return;

22.CDialog::OnCancel();

23.}

5. 辅助代码，如初始化等

01.BOOL CWizard::OnInitDialog() 

02.{

03.CDialog::OnInitDialog();

04.//获得每页显示的范围

05.CRect Rect1;

06.GetWindowRect(&Rect1); // 获得主窗口的位置

07.int nCaption = ::GetSystemMetrics(SM_CYCAPTION); // 系统Title高度

08.int nXEdge = ::GetSystemMetrics(SM_CXEDGE); 

09.int nYEdge = ::GetSystemMetrics(SM_CYEDGE);

10.CRect Rect2;

11.GetDlgItem(IDC_POS)->GetWindowRect(&Rect2); // 获得框架的位置

12.Rect1.top=Rect1.top+nCaption+nYEdge; // 相对坐标

13.Rect1.left=Rect1.left+2*nXEdge;

14.//计算机位置

15.rectPage.top=Rect2.top-Rect1.top;

16.rectPage.left=Rect2.left-Rect1.left;

17.rectPage.bottom=Rect2.bottom-Rect1.top;

18.rectPage.right=Rect2.right-Rect1.left;

19. 

20.//页示的添加要显

21.CStep1* pStep1 = new CStep1;

22.CStep2* pStep2 = new CStep2;

23.CStep3* pStep3 = new CStep3;

24. 

25.AddPage(pStep1, IDD_STEP1);

26.AddPage(pStep2, IDD_STEP2);

27.AddPage(pStep3, IDD_STEP3);

28. 

29.//显示第一页

30.ShowPage(1);

31. 

32.return TRUE;// return TRUE unless you set the focus to a control

33.// EXCEPTION: OCX Property Pages should return FALSE

34.}

因为是无模式窗体，所以要自己销毁窗体

01.void CWizard::OnDestroy()

02.{

03.CDialog::OnDestroy();

04.// TODO: Add your message handler code here

05.//每页依次消除

06.struct PAGELINK* pTemp=pPageLink;

07.while(pTemp)

08.{

09.struct PAGELINK* pNextTemp = pTemp->Next;

10.pTemp->pDialog->DestroyWindow();

11.delete pTemp->pDialog;

12.delete pTemp;

13.pTemp = pNextTemp;

14.}

15.}

6． 启动向导需要在IDC_BEGINWIZ 按钮的Click事件中加入下列代码：

1.CWizard MyWiz; //显示向导

2.MyWiz.DoModal();

 四、测试

上述两个程序在Win2000、VC++ 6.0 下编译通过。