DEACTIVATE WINDOW

From Recital Documentation Wiki
Revision as of 10:54, 23 October 2009 by Helengeorge (Talk | contribs)

Jump to: navigation, search

Purpose

Deactivate and erase a window from the screen


Syntax

DEACTIVATE WINDOW <window-name | window-name list> | ALL


See Also

ACTIVATE WINDOW, DEFINE WINDOW, HIDE WINDOW, RELEASE WINDOWS, SHOW WINDOW, WCOLS(), WEXIST(), WONTOP(), WOUTPUT(), WROWS(), WTITLE(), WVISIBLE()


Description

The DEACTIVATE WINDOW command deactivates a window that has been defined with the DEFINE WINDOW command, and activated with the ACTIVATE WINDOW command. A window is an area of the screen designated for output and input. There is no limit to the number of defined windows.

A defined window is displayed to the screen with the ACTIVATE WINDOW or SHOW WINDOW commands. The SHOW WINDOW command displays a window without activating it. The ACTIVATE WINDOW command displays a window and activates it. When a window is activated, all subsequent output is displayed in that window. Only one window may be activated at a time. The DEACTIVATE WINDOW command clears the display of activated windows, but leaves the window definition in memory. Once a window has been deactivated, all subsequent output is directed to the last activated screen, or to the full screen if there are no active windows.

The DEACTIVATE WINDOW command can be used to deactivate a single window, a list of windows, or all currently defined windows. To deactivate a single window, specify the name of the window that you wish to deactivate. The <window-name> is the name in the window definition created with the DEFINE WINDOW command. The <window-name list> is a list of window names, each separated by a comma. When deactivating a list of windows, the DEACTIVATE WINDOW command deactivates the windows in the order that they are listed. To deactivate all currently defined windows, use the keyword ALL.

If you wish to clear all windows from the screen and from memory, use the CLEAR WINDOWS or RELEASE WINDOWS command. The SAVE and RESTORE WINDOW commands may be used to keep window definitions in a file that can be reused at any time.


Example

@17,1 menu "Quit Inventory";
  help "Exit from Inventory System";
  command "deactivate window inv_win"


Products

Recital Mirage Server, Recital Terminal Developer