如需下载程序,请点击这里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)
类名 | 基类 | 说明 |
CWizard | CDialog | 向导的框架 |
CStep1 | CDialog | 向导的第一步 |
CStep2 | CDialog | 向导的第二步 |
CStep3 | CDialog | 向导的第三步 |
CCustomWizardDlg | CDialog | 启动向导 |
3. 在CWizard添加要使用的数据结构
为了方便描述,表2列出了使用到的成员变量
(表2)
成员变量 | 类型 | 说明 |
rectPage | CRect | 每页显示的范围 |
nPageCount | UINT | 页的总数 |
nCurrentPage | UINT | 正在显示的页 |
nPageLink | PAGELINK* | 用来链接所有的页 |
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 下编译通过。