|
Overview |
|
|
|
Group |
|
|
|
Quick Info
Windows NT
| Yes
| Win95
| Yes
| Win32s
| Yes
| Import Library
| user32.lib
| Header File
| winuser.h
| Unicode
| No
| Platform Notes
| None
|
|
|
EndDialog
The EndDialog function destroys a modal dialog box, causing the system to end any
processing for the dialog box.
BOOL EndDialog(
HWND hDlg,
| // handle to dialog box
| int nResult
| // value to return
| );
|
|
Parameters
hDlg
Identifies the dialog box to be destroyed.
nResult
Specifies the value to be returned to the application from the function that
created the dialog box.
Return Values
If the function succeeds, the return value is nonzero.
If the function fails, the return value is zero.
Remarks
Dialog boxes created by the DialogBox, DialogBoxParam, DialogBoxIndirect, and DialogBoxIndirectParam functions must be destroyed using the EndDialog function. An application calls EndDialog from within the dialog box procedure; the function must not be used for any
other purpose.
A dialog box procedure can call EndDialog at any time, even during the processing of the WM_INITDIALOG message. If your application calls the function while WM_INITDIALOG is being
processed, the dialog box is destroyed before it is shown and before the input
focus is set.
EndDialog does not destroy the dialog box immediately. Instead, it sets a flag and
allows the dialog box procedure to return control to the system. The system checks
the flag before attempting to retrieve the next message from the application
queue. If the flag is set, the system ends the message loop, destroys the dialog
box, and uses the value in nResult as the return value from the function that created the dialog box.
See Also
DialogBox, DialogBoxIndirect, DialogBoxIndirectParam, DialogBoxParam, WM_INITDIALOG
Related Links
Software for Delphi and C++ Builder developers
Software for Visual Studio .NET developers
Software for Visual Basic 6 developers
Delphi Tips&Tricks
MegaDetailed.NET
TMS Scripter Studio Pro components for Delphi/C++Builder
More Online Helps
Win32 Multimedia Programmer's Reference (mmedia.hlp)
OLE Programmer's Reference (ole.hlp)
Microsoft Windows Pen API Programmer's Reference (penapi.hlp)
Microsoft Windows Sockets 2 Reference (sock2.hlp)
Microsoft Windows Telephony API (TAPI) Programmer's Reference (tapi.hlp)
Unix Manual Pages
|
