+---------------------------------+
|           DEFINE BOX            |
+---------------------------------+
DEFINE BOX FROM <col1> TO <col2>
        HEIGHT <expN1>
        [AT LINE <expN2>]
        [SINGLE | DOUBLE
        | <border string>]

-----------------------------------
Draws box around printed text.
-----------------------------------

This command draws a box around text in printed reports.  DEFINE BOX
only draws boxes in printed reports and only if the _BOX system memory
variable is set to true (.T.).  To draw boxes on the screen, use the @
... BOX or @ ... TO commands.

A box can only be printed if SET PRINT is ON.  Boxes can only be drawn
around output created with the ? or ?? commands.  Boxes cannot be drawn
around output from the @ ... SAY command.

The size of the box is specified by the values of <col1>, <col2> and
<expN1>.  The upper left corner of the box will appear in print column
<col1>.  The upper right corner will appear in column <col2>.  The
height of the box will be <expN1>.  The height of the box is affected by
the value of the system memory variable _PSPACING.  For example, if
<expN1> is set to 5 and _PSPACING is set to 3 the height of the box will
be 15 lines.

The top of the box will be drawn beginning at the current print line
unless the AT LINE clause is used.  Including a line number in the AT
LINE <expN2> clause will specify where the top line of the box will
begin.

You may also specify a different border style for the box with the
SINGLE, DOUBLE or <border string> options.  The default border is a
single line.  DOUBLE draws a double line box.  You may define your own
border with the <border string> option.  The syntax for the border
string is identical to that in the SET BORDER command.  See the SET
BORDER command for more information on creating your own border.

Two functions that are useful with DEFINE BOX are PCOL() and PROW().
These functions return the current print column and print row positions.

Clauses
-------

<col1> TO <col2>
        Numeric coordinates (zero or greater) of upper left corner and upper
right corner of box.

HEIGHT <expN1>
        Height of box.

AT LINE <expN2>
        Specifies where top line of box begins.

SINGLE | DOUBLE | <border string>
        Specifies border style.

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

See Also:  @ ... BOX, PCOL(), PROW(), SET BORDER

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