+---------------------------------+
|           SHOW WINDOW           |
+---------------------------------+
SHOW WINDOW <window name1>
        [, <window name2> ... ] | ALL
        [IN [WINDOW] <window nameN>
        | IN SCREEN]
        [REFRESH]
        [TOP | BOTTOM | SAME]
        [SAVE]

-----------------------------------
Places previously defined window on  screen.
-----------------------------------

SHOW WINDOW controls the display and front-to-back screen placement of
windows.  If window or windows have been defined but not activated, SHOW
WINDOW places them on the screen.  If a window or windows are hidden,
SHOW WINDOW will place them on the screen.

You can also show system windows like the Command window, the
Calculator, the Calendar/Diary, etc.  Desk accessories (Filer, the
Calculator, etc.) must be active before they can be shown. If a window
or windows are currently displayed on the screen, SHOW WINDOW lets you
change the front-to-back order in which they appear on the screen.

You cannot specify where output will be directed with SHOW WINDOW.  To
direct output to a window, you must use ACTIVATE WINDOW.

Clauses
-------

<window name1> [,<window name2>...]
        One or more windows to be placed on screen.

ALL
        Places all windows on screen.

IN [WINDOW] <window nameN>
        If IN WINDOW <window nameN> is included, window is opened within a
parent window.  It does not assume characteristics of parent window it
is placed in.  A window activated inside a parent window cannot be moved
outside the parent window.  If parent window is moved, child window
moves with it.  The parent window <window nameN> must first be defined
with DEFINE WINDOW.

IN SCREEN
        This clause lets you explicitly place a window on the screen instead of
inside another window.  Windows are placed on the screen by default.

REFRESH
        You can include REFRESH clause to redraw a Browse window.  This is
useful on a network to ensure that each user is browsing the most
current version of a database.

TOP
        Places window in front of all other displayed windows.

BOTTOM
        Places window behind all other currently displayed windows.

SAME
        Affects only windows that have been previously shown or activated, and
later removed from the screen with DEACTIVATE WINDOW. Issuing SHOW
WINDOW with the SAME option places windows back into a stack of windows
in the same position they occupied before they were deactivated.

SAVE
        SAVE keeps an image of a window on the screen or in another window
after the window has been hidden.  Normally, windows are removed from
the screen after they are hidden.  The window image may be cleared from
the screen or a window with CLEAR.  You cannot save an image of the
current output window.

+---------------------------------+
|         Program Example         |
+---------------------------------+
CLEAR
DEFINE WINDOW output FROM 2,1 TO 13,75 TITLE 'Output' ;
        CLOSE FLOAT GROW SHADOW ZOOM
SHOW WINDOW output

In this example, a window named OUTPUT is defined and shown on the
screen.  Since it is placed on the screen with SHOW WINDOW, output may
not be directed to it until it is activated.

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

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

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