+---------------------------------+
|          MODIFY SCREEN          |
+---------------------------------+
MODIFY SCREEN [<file> | ?]
        [[WINDOW <window name1>]
        [IN [WINDOW] <window name2>
        | IN SCREEN]]
        [NOENVIRONMENT]
        [NOWAIT]
        [SAVE]

-----------------------------------
Opens Screen Design window.
-----------------------------------

This format of MODIFY is used for modifying existing screen definition
files.  Screen definition files are created with CREATE SCREEN or by
choosing New... from the File menu popup.

<file>
        An existing screen may be modified by including the name of the screen
<file>.  If the file name you include doesn't exist or cannot be found,
a new screen may be created.

        Issuing MODIFY SCREEN without any additional arguments causes the Open
File dialog to appear.  The name UNTITLED is assigned to the screen.
When you exit the screen layout window you may save the screen with a
different name.

?
        If you include ? the Open File dialog appears displaying a list of
existing screen files to choose from, or you may choose the New push
button to create a new screen.

WINDOW <window name1>
        If you include WINDOW <window name1>, the screen layout window takes on
the characteristics of <window name1>.  For example, if <window name1>
was defined with the FLOAT option of DEFINE WINDOW, the screen layout
window can be moved.  The window specified in <window name1> need not be
active or visible, but it must be defined.

IN [WINDOW] <window name2>
        If IN WINDOW <window name2> is included, the screen layout window is
opened within a parent window.  It does not assume the characteristics
of the parent window it is placed in.  A screen layout window activated
inside a parent window cannot be moved outside the parent window.  If
the parent window is moved, the screen layout window moves with it.

        The parent window <window name2> must first be defined with DEFINE
WINDOW.  <window name2> must be visible to access the screen layout
window.

IN SCREEN
        You may also specifically place a SCREEN layout window on the desktop
by including IN SCREEN.  This clause lets you explicitly place a SCREEN
layout window on the desktop instead of inside a window.  SCREEN layout
windows are placed on the desktop by default.

NOENVIRONMENT
        When creating a screen you may optionally save the current FoxPro
environment with the screen definition file.  Saving the environment
places an additional record in the screen definition database.  This
record contains the names of all open database and index files, the
index order and any relationships between the databases.

        MODIFY SCREEN automatically restores the environment saved with the
screen definition file (if the environment was saved).  If you include
NOENVIRONMENT, the environment is not restored.  Include NOENVIRONMENT
to prevent changes to the current environment.

NOWAIT
        When MODIFY SCREEN is issued from within a program, a screen layout
window is opened and program execution pauses until the screen layout
window is closed.  Including NOWAIT continues program execution after
the screen layout window has been opened.  The program doesn't wait for
the screen layout window to be closed, but continues executing on the
program line immediately following that containing the MODIFY SCREEN
NOWAIT command.

        Including NOWAIT has no effect on the MODIFY SCREEN command when it is
issued from the Command window.

SAVE
        The SAVE option keeps the SCREEN layout window on the screen after
leaving the layout window.  Normally, a layout window opened with MODIFY
SCREEN is removed from the screen after you leave the layout window.

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

See Also:  CREATE SCREEN, SET FORMAT

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