The function is effective only on Windows platforms. It takes a dialog name as the single argument and unloads it, thereby deleting all QT widgets (controls) associated with the dialog, reducing the HANDLE (USER Objects) count of the parent process e.g. 'aview'. On Windows platforms, the maximum allowable HANDLE limit for a process is 10,000, after which, programs are known to behave erratically.
The function has been provided so that users can tackle this limitation, inherent to Windows platforms and can carry on with their normal working. As such, the function, though available on other platforms, does nothing.
Format
GUICLEANUP(object)
Argument
Object | The dialog box name |
Example
The function takes just one argument, which is the name of the dialog whose widgets have to be unloaded. Please note that it is recommended that the function be used only through an eval() call. The following example describes this in detail,
var cre var = temp int = ( eval ( guicleanup (about_adams) ) ) ... recommended
var cre var = temp int = ( guicleanup (about_adams) ) ... not recommended
Failing to use the GUICLEANUP function in an eval() statement introduces an undesireable dependency between the dialog and the variable and may lead to unpredictable behavior.
Note: | The function CANNOT be used to unload the function-builder dialog. |