NGU-DIALOG-CLOSE-ALL Subprogram and Subroutine

This document covers the following topics:

Natural Object Names

NGUDICL1 NGUDICLS

Description

Both the subprogram and the subroutine close all child dialogs of a given dialog. If you execute them, the close event occurs for all child dialogs. You can use them, for example, to close all MDI child dialogs in an MDI application. The difference between the two is that you use the NGUDICLS subroutine if you are accessing a global data area while closing all child dialogs. NGUDICLS is to be found in library SYSNGU. If the dialog calling this subprogram/subroutine is an MDI child dialog itself and all MDI child dialogs are to be closed, you must specify the parent of this dialog (the MDI frame dialog) as parameter. The MDI child dialog calling this subprogram/subroutine will then be the last to be closed.

Parameters

Name/Data Type Explanation
HANDLE OF GUI Input Handle of the dialog whose child dialogs are to be closed.
Response (I4) Output Natural error (if applicable).

Examples: 

   CALLNAT NGU-DIALOG-CLOSE-ALL #MYDIA #RESPONSE /* NGUDICL1 subprogram 
   PERFORM NGU-DIALOG-CLOSE-ALL #MYDIA #RESPONSE /* NGUDICLS subroutine