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

-----------------------------------
Opens Report Layout window.
-----------------------------------

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

<file>
        An existing report may be modified by including the name of the report
<file>.  If the file name you include doesn't exist or cannot be found,
a new report may be created.  To modify a report created in FoxBASE+,
you must include the .FRM file extension.

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

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

WINDOW <window name1>
        If you include WINDOW <window name1>, the report layout window takes on
the characteristics of <window name1>.  For example, if <window name1>
was defined with the FLOAT option of DEFINE WINDOW, the report 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 report layout window is
opened within a parent window.  It does not assume the characteristics
of the parent window it is placed in.  A report layout window activated
inside a parent window cannot be moved outside the parent window.  If
the parent window is moved, the report 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 report layout
window.

IN SCREEN
        You can specifically place a report layout window on the screen by
including IN SCREEN.  This clause lets you explicitly place a report
layout window on the screen instead of inside a window.  Report layout
windows are placed on the screen by default.

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

        MODIFY REPORT automatically restores the environment saved with the
report 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 REPORT is issued from within a program, a report layout
window is opened and program execution pauses until the report layout
window is closed.  Including NOWAIT continues program execution after
the report layout window has been opened.  The program doesn't wait for
the report layout window to be closed, but continues executing on the
program line immediately following that containing the MODIFY REPORT
NOWAIT command.

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

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

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

See Also:  CREATE REPORT, REPORT

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