6.1.3 对话框的基类的成员函数
CDialog类是模态对话框和非模态对话框的基类,其常用的成员函数有以下几个。
(1)DoModal
该函数用于激活模态对话框,完成后返回对话框结果。其原型为:
virtual int DoModal( );
返回值:若不可创建对话框,则返回1;若错误,则返回IDABORT。
(2)Create
Create函数用于使用对话框模板从资源中创建一个非模态对话框。其原型为:
返回值:若对话框创建和初始化成功,则返回非0值;否则返回0。
参数:lpszTemplateName为以NULL结束的字符串,该字符串为对话框模板资源名。pParentWnd指向该对象所属的父窗口对象。若为NULL,则父窗口设置为主程序窗口。nIDTemplate对话框模板资源的ID号。
(3)EndDialog
该函数用于退出一个模态对话框,返回nResult作为DoModal的返回值,其原型为:
void EndDialog( int nResult );
参数:nResult从对话框中返回给DoModal调用者的值。
(4)OnCancel
该函数是单击模态或非模态对话框中的“Cancel”按钮或按“Esc”键时,由框架调用,其原型为:
virtual void OnCancel( );
(5)OnInitDialog
该重载函数用于响应WM_INTTDIALOG消息,对对话框进行初始化处理,其原型为:
virtual BOOL OnInitDialog( );
返回值:返回非0值,输入焦点为第一个控件。若程序已显式地设置焦点到某个控件处,则返回0。
(6)OnOK
单击“OK”按钮(ID号为IDOK的按钮)时调用的函数,关闭对话框,并返回IDOK。
virtual void OnOK( );
【责任编辑:
杨硕 TEL:(010)68476636-8001】