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

-----------------------------------
Opens a Label Layout window.
-----------------------------------

Issuing the command MODIFY LABEL without any additional arguments opens
a label layout window where you may create new labels.  The name
"UNTITLED" is temporarily assigned to the label layout window.  When you
exit the label layout window you may save the labels with a different
name.  After you have created new labels, the label definition is stored
as a FoxPro database file with a .LBX extension.  A label definition
database may be opened with the USE command and manipulated like any
other FoxPro database.  A table with the structure of labels definition
databases is available in the Label Generator section of the Interface
Guide.

Clauses
-------

<file>
        Existing labels may be modified by including the name of the label
definition database <file>.  If the file name you include doesn't exist
or cannot be found, new labels may be created.

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

WINDOW <window name1>
        You may place the LABEL layout window within another window.  If you
use the WINDOW <window name1> clause the LABEL layout window will fill
the entire window and take on the characteristics of the window it is
placed in.  For example, if the window was defined with the FLOAT and
GROW options of the DEFINE WINDOW command, the LABEL layout window can
be moved and resized.

        The LABEL layout window has a default size which may be larger than the
window you try to place it in.  In this case the LABEL layout window
still assumes the characteristics of the window it is placed in.  The
LABEL layout window is placed in the upper left corner of the window and
may extend beyond the borders of the window it is placed in.

IN WINDOW <window name2>
        If the IN WINDOW <window name2> option is used, the LABEL layout window
is opened independently within a parent window.  It does not assume the
characteristics of the parent window it is placed in.  A LABEL layout
window activated inside a parent window may not be moved outside the
parent window, and if the parent window is moved, the LABEL layout
window moves with it.

        The parent window the LABEL layout window is placed in must first be
defined with the DEFINE WINDOW command.

IN SCREEN
        You may also specifically place a LABEL layout window on the screen by
including an IN WINDOW SCREEN or IN SCREEN clause.  These clauses let
you explicitly place a LABEL layout window on the screen instead of
inside a window.  LABEL layout windows are placed on the screen by
default.

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

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

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

        This option is available only from within programs.  Including the
NOWAIT option has no effect on the MODIFY LABEL command when it is
issued from the Command window.

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

        This option is only available from within programs.  Including the SAVE
option in the MODIFY LABEL command has no effect when this command is
issued from within the Command window.

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

See Also:  CREATE LABEL, LABEL

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