CLOSE WINDOW
CLOSE WINDOW {( window )}
| Parameter | Type | Description | |
|---|---|---|---|
| window | Integer | → | Window reference number, or Frontmost window of current process, if omitted |
This command is not thread-safe, it cannot be used in preemptive code.
Description
CLOSE WINDOW closes the active window opened by the Open window or Open form window command in the current process. CLOSE WINDOW has no effect if a custom window is not open; it does not close system windows. CLOSE WINDOW also has no effect if called while a form is active in the window. You must call CLOSE WINDOW when you are done using a window opened by Open window or Open form window.
It is useless to pass a number to CLOSE WINDOW when closing a window previously opened by the Open window or Open form window function, since a call to CLOSE WINDOW will always close the last window created by one of these commands.
If you pass an external window reference number in the Window parameter, CLOSE WINDOW closes the specified external window. For more information about external windows, refer to the function.
Example
The following example opens a form window and adds new records with the ADD RECORD command. When the records have been added, the window is closed with CLOSE WINDOW:
FORM SET INPUT([Employees];"Entry")
$winRef:=Open form window([Employees];"Entry")
Repeat
ADD RECORD([Employees]) //Add a new employee record
Until(OK=0) //Loop until the user cancels
CLOSE WINDOW //Close the window