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

注解

此方法处理当对话框处于活动状态时与用户的所有交互。 这会使对话框模式化;也就是说,在对话框关闭之前,用户不能与其他窗口交互。

另请参阅

类概述