ACTIVATE WINDOW

Purpose

Activate a defined window, or list of windows.

Syntax

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

[NOSHOW]

See Also

ACTIVATE SCREEN, CLEAR WINDOWS, DEACTIVATE WINDOW, DEFINE WINDOW, HIDE WINDOW, MOVE WINDOW, RELEASE WINDOWS, RESIZE WINDOW, RESTORE WINDOW, SAVE WINDOW, SHOW WINDOW, WCOLS(), WEXIST(), WONTOP(), WOUTPUT(), WROWS(), WTITLE(), WVISIBLE()

Description

The ACTIVATE WINDOW command displays and activates windows that have been defined with the DEFINE WINDOW command. When a window is activated, all subsequent output is displayed in that window. Only one window may be activated at a time. Activating additional windows does not clear the display of previously activated windows. The DEACTIVATE WINDOW command clears the display of activated windows, but leaves the window definition in memory. The RELEASE WINDOW command clears both the display and the definition of windows from memory. The SAVE and RESTORE WINDOW commands may be used to keep window definitions in a file that can be reused at any time.

The ACTIVATE WINDOW command can be used to activate a single window, a list of windows, or all currently defined windows. To activate a single window, specify the name of the window that you wish to activate. 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 activating a list of windows, the ACTIVATE WINDOW command displays the windows in the order that they are listed, and the last window in the list is activated. To display all currently defined windows, use the keyword ALL. The windows display in the order that they are defined, and the last window defined is activated.

NOSHOW

If the NOSHOW keyword is included, the specified window will be activated, but will not be displayed on the screen until the SHOW WINDOW <window-name> command is issued.

Example

define window win1;
  from 2,2 to 12,43
activate window win1 noshow
dir
wait
show window win1

Products

Recital