DELETE-WINDOW Action

This document covers the following topics:


Description

For the specified dialog, and its child dialogs (if any), this action destroys the dialog's window (if it exists) and causes the dialog object to be unloaded as soon as all currently executing events for that dialog have been completed. Note that the dialog does not receive a CLOSE event.

Note:
You do not normally need to call this action explicitly, as the dialog implicitly generates a call to this action that is executed during CLOSE event handling. Therefore, it is recommended that the CLOSE DIALOG statement statement be used in preference to this action.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input

Handle of the dialog's window, or NULL-HANDLE. In the latter case, the dialog specified by the system variable *DIALOG-ID is unloaded.

Response (I4) Output

Natural error (if applicable).

Example:

PROCESS GUI ACTION DELETE-WINDOW WITH #DLG$WINDOW GIVING #RESPONSE