RELEASE WINDOWS

From Recital Documentation Wiki
Jump to: navigation, search

Purpose

Delete window definitions and free the storage space that they were occupying


Syntax

RELEASE WINDOWS <window-name> | <window-name list> | ALL


See Also

ACTIVATE WINDOW, CLEAR WINDOWS, DEACTIVATE WINDOW, DEFINE WINDOW, RESTORE WINDOW, SAVE WINDOW, SHOW WINDOW, WCOLS(), WEXIST(), WONTOP(), WOUTPUT(), WROWS(), WTITLE(), WVISIBLE()


Description

The RELEASE WINDOWS command removes windows from memory and from the screen. A window is an area of the screen designated for output and input. There is no limit to the number of defined windows. Windows are defined with the DEFINE WINDOW command, and activated with the ACTIVATE WINDOW command. You may release a single window, a group of windows, or all currently defined windows. The <window-name> is the name of the window as specified in the DEFINE WINDOW command. To release a group of windows, use a <window-name list>, which is a list of window names, each separated by a comma. To release all currently defined windows, use the ALL keyword.

The RELEASE WINDOWS command is a quick way to clear the screen and reclaim memory space for more windows. Once the RELEASE WINDOWS command is issued, the DEFINE WINDOW command must be used to establish further window definitions, and the ACTIVATE WINDOW or SHOW WINDOW commands must be used to display them. The RELEASE WINDOWS command is synonymous with the CLEAR WINDOWS command.

If you wish to clear a window from the screen, but retain its definition in memory, use the DEACTIVATE WINDOW command. If you wish to clear a window from the screen, but keep it active, use the HIDE WINDOW command. If you wish to clear windows from the screen, and save the window definition and the current window contents to a file, use the SAVE WINDOW and RESTORE WINDOW commands.


Example

release windows


Products

Recital