Purpose |
Close and destroy the specified dialog. |
Syntax |
DIALOG END hDlg [, lResult&] |
Remarks |
The dialog specified by the hDlg variable is destroyed. lResult& optionally specifies a value to return to the DIALOG SHOW MODAL or DIALOG SHOW MODELESS statement that activated the dialog initially. |
Restrictions |
DIALOG END cannot close or destroy a dialog in a separate thread. In this case, send or post a message to the dialog to signal it to close, and respond to the message in the callback for the specified dialog. For example: ' Trigger a DIALOG END in a separate thread DIALOG SEND hDlg, %WM_SYSCOMMAND, %SC_CLOSE, 0 DIALOG END cannot be used during processing of the %WM_INITDIALOG message. If this effect is necessary, the solution is to post a user-defined message to the dialog and use DIALOG END at that point. For example: CALLBACK MyDialogCallback SELECT CASE CB.MSG CASE %WM_INITDIALOG IF gMustEnd& THEN _ ' We have to stop! DIALOG POST CB.HNDL, %WM_USER+999&, 0, 0
CASE %WM_USER + 999& DIALOG END CB.HNDL FUNCTION = 1 END SELECT END FUNCTION |
See also |
Dynamic Dialog Tools, DIALOG NEW, DIALOG SHOW MODELESS, THREAD CREATE |