EndDialog

【勇芳软件工作室】汉化HomePreviousNext

EndDialog功能会销毁模态对话框,导致系统结束对话框的任何处理。

BOOL EndDialog(

HWND 【hDlg】,//对话框的句柄
INT 【如果函数失败,返回值为-1。】//返回值
); 

参数

【hDlg】

标识要销毁的对话框。

【如果函数失败,返回值为-1。】

从创建对话框的函数中指定要返回给应用程序的值。

返回值

如果函数成功,返回值不为零。

如果函数失败,返回值为零。

备注

DialogBoxDialogBoxParamDialogBoxIndirectDialogBoxIndirectParam功能创建的对话框必须使用EndDialog功能销毁。应用程序从对话框程序中调用EndDialog该函数不得用于任何其他目的。

即使在WM_INITDIALOG消息的处理期间,对话框过程也可以随时调用EndDialog.如果您的应用程序在处理WM_INITDIALOG时调用该函数,则在显示该对话框之前以及在设置输入焦点之前,对话框将被销毁。

EndDialog不立即破坏对话框。相反,它设置一个标志,并允许对话框过程将控制权返回给系统。在尝试从应用程序队列中检索下一条消息之前,系统会检查该标志。如果设置了标志,系统将结束消息循环,销毁对话框,并使用【如果函数失败,返回值为-1。】中的值作为创建对话框的功能的返回值。

也可以看看

DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG