EndDialog功能会销毁模态对话框,导致系统结束对话框的任何处理。
BOOL EndDialog(
HWND 【hDlg】, | //对话框的句柄 |
INT 【如果函数失败,返回值为-1。】 | //返回值 |
); |
参数
【hDlg】
标识要销毁的对话框。
【如果函数失败,返回值为-1。】
从创建对话框的函数中指定要返回给应用程序的值。
返回值
如果函数成功,返回值不为零。
如果函数失败,返回值为零。
备注
DialogBox,DialogBoxParam,DialogBoxIndirect和DialogBoxIndirectParam功能创建的对话框必须使用EndDialog功能销毁。应用程序从对话框程序中调用EndDialog该函数不得用于任何其他目的。
即使在WM_INITDIALOG消息的处理期间,对话框过程也可以随时调用EndDialog.如果您的应用程序在处理WM_INITDIALOG时调用该函数,则在显示该对话框之前以及在设置输入焦点之前,对话框将被销毁。
EndDialog不立即破坏对话框。相反,它设置一个标志,并允许对话框过程将控制权返回给系统。在尝试从应用程序队列中检索下一条消息之前,系统会检查该标志。如果设置了标志,系统将结束消息循环,销毁对话框,并使用【如果函数失败,返回值为-1。】中的值作为创建对话框的功能的返回值。
也可以看看
DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG