Skip to main content
Version: Next

CLOSE WINDOW

CLOSE WINDOW {( window )}

ParameterTypeDescription
windowIntegerWindow reference number, or Frontmost window of current process, if omitted

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

See also

Open form window
Open window

Properties

Command number154
Thread safe