+---------------------------------+
|         ACTIVATE WINDOW         |
+---------------------------------+
ACTIVATE WINDOW [<window name1>
        [, <window name2> ... ]] | ALL
        [IN [WINDOW] <window name3>
        | SCREEN]
        [BOTTOM | TOP | SAME] [NOSHOW]

-----------------------------------
Displays and activates a window.
-----------------------------------

This command displays and activates a previously defined user window or
windows.  Activating a window makes it the frontmost window and directs
all screen output to that window.  A window remains the current output
window until it is deactivated or released, or until another window or
the screen is activated.

User windows are created and defined with DEFINE WINDOW.  When windows
are defined, their names appear in the bottom section of the Window menu
popup of the system menu bar.  The window that output is currently being
directed to is marked with a diamond in the Window menu popup.

More than one window can be placed on the screen at one time, but output
will only be directed to the last window activated.  When more than one
window is present, deactivating the current output window will remove it
from the screen and will cause subsequent output to be directed to
another window.  If there is no output window, output is directed to the
screen.

To guarantee that a particular window is activated when you deactivate
the current output window, you must explicitly activate the window with
ACTIVATE WINDOW.

All activated windows remain on the screen until DEACTIVATE WINDOW or
HIDE WINDOW is used to remove them from the screen.  Using either of
these two commands removes windows from the screen but not from memory.
Windows may be placed back on the screen again with ACTIVATE WINDOW or
SHOW WINDOW. To remove windows from both the screen and memory, use
CLEAR WINDOWS, RELEASE WINDOWS or CLEAR ALL. Windows that are removed
from memory must be defined again to place them back on the screen.

Clauses
-------

<window name1>, <window name2>
        The windows to be activated.

ALL
        Activates all defined windows.

IN [WINDOW] <window nameN>
        Places activated window(s) parent window <window nameN>.

IN [WINDOW] SCREEN
        Places windows on screen instead of inside window.

BOTTOM | TOP | SAME
        Controls where windows are activated with reference to other previously
activated windows.

NOSHOW
        Directs output to named user window without making window visible.

+---------------------------------+
|             Example             |
+---------------------------------+
This example defines window named OUTPUT and activates it, placing it on
screen.  WAIT pauses execution, then window is hidden and finally
brought back to screen.

CLEAR
DEFINE WINDOW output FROM 2,1 TO 13,75 TITLE 'Output' ;
        CLOSE FLOAT GROW SHADOW ZOOM
ACTIVATE WINDOW output
WAIT
HIDE WINDOW output
WAIT
SHOW WINDOW output

-----------------------------------

See Also:  DEACTIVATE WINDOW, DEFINE WINDOW, HIDE WINDOW, SHOW WINDOW

-----------------------------------