按键盘上方向键 ← 或 → 可快速上下翻页,按键盘上的 Enter 键可回到本书目录页,按键盘上方向键 ↑ 可回到本页顶部!
————未阅读完?加入书签已便下次继续阅读!
(4 )GetPage()函数
该函数返回某个属性页对象,原型如下:
CPropertyPage* GetPage(
int nPage
) const;
o nPage 参数:表示所要获取的属性页的序号,从零开始。
o 返回值:属性页对象的指针。
(5 )GetPageCount()函数
该函数返回属性页的总数,原型如下:
int GetPageCount( ) const;
返回值为属性页的总数。
(6 )GetPageIndex()函数
该函数获取属性页在对话框中的序号,原型如下:
int GetPageIndex(
CPropertyPage* pPage
);
o pPage 参数:要获取序号的属性页对象的指针。
o 返回值:属性页对象对应的序号。
(7 )SetActivePage()函数
该函数设置某个属性页为当前活动的属性页,原型如下:
·80 ·
…………………………………………………………Page 90……………………………………………………………
第 4 章 对话框
BOOL SetActivePage(
int nPage
);
BOOL SetActivePage(
CPropertyPage* pPage
);
o nPage 参数:要设置为活动的属性页的序号。
o pPage 参数:要设置为活动的属性页的对象指针。
o 返回值:表示操作是否成功。
(8)SetTitle()函数
该函数设置属性表的标题,原型如下:
void SetTitle(
LPCTSTR lpszText;
UINT nStyle = 0
);
o lpszText 参数:新的标题字符串指针。
o nStyle 参数:设置标题的属性,只能为 0 或者 PSH_PROPTITLE 。取值为 0 时没有附
加属性;取值为 PSH_PROPTITLE 会在新的标题后面添加“属性”两个字,比如 lpszText
为“Text ”,则当 nStyle 为 PSH_PROPTITLE 时,真正的标题显示为“Text 属性”。
(9 )AddPage() 函数
该函数为属性表添加新的属性页,原型如下:
void AddPage(
CPropertyPage *pPage
);
pPage 参数为要添加的属性页对象的指针标题字符串。
(10)PressButton() 函数
该函数模拟单击属性表的某个按钮,原型如下:
void PressButton(
int nButton
);
nButton 参数给出要模拟单击的按钮,可以取下列值中的一个。
o PSBTN_BACK :选择“上一步”按钮。
o PSBTN_NEXT :选择“下一步”按钮。
o PSBTN_FINISH :选择“完成”按钮。
o PSBTN_OK :选择“确认”按钮。
o PSBTN_APPLYNOW :选择“应用”按钮。
o PSBTN_CANCEL :选择“取消”按钮。
o PSBTN_HELP :选择“帮助”按钮。
·81 ·
…………………………………………………………Page 91……………………………………………………………
Visual C++ 6。0 程序设计从入门到精通
(11)RemovePage() 函数
该函数为属性表删除已有的属性页,原型如下:
void RemovePage(
CPropertyPage *pPage
);
void RemovePage(
int nPage
);
o pPage 参数:要删除的属性页的对象指针。
o nPage 参数:要删除的属性页的序号。
(12)SetWizardButtons()函数
该函数进行设置向导对话框的典型按钮(比如前进、后退、完成等)。注意该函数必须
在调用 DoModal()时才能使用,因此一般在属性页中的 CPropertySheet::OnSetActive()函数中
调用。函数其原型为:
void SetWizardButtons(
DWORD dwFlags
);
dwFlags 参数设置向导按钮的属性,可以为以下值的组合:
o PSWIZB_BACK :显示“上一步”按钮,如果没有包含该值,“上一步”按钮被禁用。
o PSWIZB_NEXT :显示“下一步”按钮,如果没有包含该值,“下一步”按钮被禁用。
o PSWIZB _FINISH :显示“完成”按钮。
o PSWIZB _DISABLEFINISH :显示被禁用的“完成”按钮。
(13)SetWizardMode ()函数
该函数设置属性页对话框为向导对话框模式,应当在调用 DoModal() 函数之前调用该函
数。其原型为:
void SetWizardMode( );
(14)DoModal () 函数
该函数显示一个模态属性页对话框,其原型为:
virtual INT_PTR DoModal( );
返回值:返回对话框关闭的状态,对于一般属性页,返回值一般为 IDOK、IDCANCEL
或者 0 ;对于向导对话框返回值为 ID_WIZFINISH 或 IDCANCEL 。
4。4。2 向导对话框的创建步骤
向导对话框用于完成一系列设置步骤,每一步通过“上一步”和“下一步”按钮进行切
换。本节将在实例 Sample4_1 的基础上创建一个有 3 个步骤(包含 3 个属性页)的向导对话
框。
实例 4…4 :创建向导对话框实例。源代码在光盘中“04实例 4…4Sample4_1 ”目录下。
·82 ·
…………………………………………………………Page 92……………………………………………………………
第 4 章 对话框
1.创建属性页模板
创建向导对话框首先要创建属性页模板,步骤如下:
(1)打开实例 Sample4_1 的工程后,在 IDE 中依次选择菜单“Insert|Resource ”,打开“Insert
Resource ”对话框。在“Resource type ”属性列表框中选择 Dialog 选项,单击“New ”按钮,
创建一个默认 ID 为 IDD_DIALOG1 的新的对话框资源。
(2 )在 IDE 左侧工作区中单击“ResourceView ”选项卡,展开“Sample4_1 resources|Dialog”,
找到 IDD_DIALOG1 ,在其上单击鼠标右键,选择菜单“Properties ”,打开对话框资源属性设
置 对 话 框 。 在 “ ID 输 入 框 ” 中 输 入 IDD_TESTPAGE1 , 即 设 置 对 话 框 资 源 ID 为
IDD_TESTDPAGE1 ,回车关闭属性设置对话框并确认修改。
(3 )在 IDE 左侧“ResourceView ”选项卡中,双击刚刚修改过的 IDD_TESTPAGE1 ,打
开 IDD_TESTPAGE1 的对话框资源编辑器,在 IDE 右侧客户区的对话框上单击鼠标右键,选
择菜单项“Properties ”,打开该对话框的属性设置对话框。
(4 )在对话框的属性设置对话框中设置对话框的标题。单击“General ”选项卡,在“Caption ”
输入框中输入“测试页 1”。
(5 )仍在步骤 4 中对话框的属性设置对话框中,设置对话框的样式为属性页对话框的样
式。单击“Styles”选项卡,如图 4…22 所示。在“Style”下拉列表框中选择 Child,在“Border ”
下拉列表框中选择“Thin ”,选中“Title bar ”复选框,清除其他复选框的选项,如图 4…22 所
示。回车确认设置并关闭此对话框。
(6 )按照 4。1。2 节第 3 部分的讲解,删除 IDD_TESTPAGE1 中的“确认”(OK )按钮和
Cancel )按钮,并为 IDD_TESTPAGE1 添加合适的控件。完成控件的添加后,
“�