CSimpleDialog 类
此类实现基本模式对话框。
语法
template <WORD t_wDlgTemplateID, BOOL t_bCenter = TRUE>
class CSimpleDialog : public CDialogImplBase
参数
t_wDlgTemplateID
对话框模板资源的资源 ID。
t_bCenter
如果对话框对象位于所有者窗口上,则为 TRUE;否则为 FALSE。
成员
公共方法
名称 | 描述 |
---|---|
CSimpleDialog::DoModal | 创建模式对话框。 |
备注
实现具有基本功能的模式对话框。 CSimpleDialog
仅提供对 Windows 公共控件的支持。 若要创建和显示模式对话框,请创建此类的实例,为对话框提供现有资源模板的名称。 当用户单击具有预定义值的任何控件(如 IDOK 或 IDCANCEL)时,对话框对象将关闭。
CSimpleDialog
仅允许创建模式对话框。 CSimpleDialog
提供对话框过程,它使用默认消息映射将消息定向到相应的处理程序。
有关详细信息,请参阅“实现对话框”。
继承层次结构
CDialogImplBase
CSimpleDialog
要求
标头:atlwin.h
CSimpleDialog::DoModal
调用模式对话框并在完成后返回对话框结果。
INT_PTR DoModal(HWND hWndParent = ::GetActiveWindow());
参数
hWndParent
对话框的父窗口句柄。 如果未提供任何值,则父窗口设置为当前活动窗口。
返回值
如果成功,则返回值是关闭对话框的控件的资源 ID。
如果函数失败,返回值为 -1。 若要获得扩展的错误信息,请调用 GetLastError
。
注解
此方法处理当对话框处于活动状态时与用户的所有交互。 这会使对话框模式化;也就是说,在对话框关闭之前,用户不能与其他窗口交互。