DEFINE BOX Command
|Visual FoxPro 9.0 SP2|
|DEFINE BOX Command|
Included for backward compatibility. Use the Report Designer instead.
This command is undocumented in the original VFP9 help file,
but the following documentation was found in the FoxPro for Windows 2.6 help, and may still be valid:
Draws a box around printed text.
DEFINE BOX FROM column1 TO column2 HEIGHT expN1 [AT LINE expN2] [SINGLE | DOUBLE | border string]
Included for backward compatibility use the Screen Builder instead.
This command draws a box around text only in printed reports and only if the BOX system memory variable is set to true (.T.). Use @ ...BOX or @ ... TO to draw boxes in the main FoxPro window or a user-defined window.
A box can be printed only if SET PRINTER is ON. Boxes can be drawn only around output created with the ? or ?? command. Boxes cannot be drawn around output created with @ ... SAY.
Two functions that are useful with DEFINE BOX are PCOL() and PROW(). These functions return the current print column and print row positions.
FROM column1 TO column2
The upper-left corner of the box appears in print column column1. The upper-right corner appears in column column2.
The height of the box is specified with expN1. Box height is affected by the value of the system memory variable _PSPACING. For example, if expN1 is set to 5 and _PSPACING is 3, the height of the box is 15 lines.
AT LINE expN2
The top of the box is drawn beginning at the current print line unless you include AT LINE expN2 in DEFINE BOX. expN2 is the number of the line at which you want the top of the box to be drawn.
SINGLE | DOUBLE | border string
The default border of the box is a single line. You can specify a different border style with the SINGLE, DOUBLE or border string clause. Include SINGLE to draw a single-line border; include DOUBLE to draw a double-line border. You can define your own border with border string. The syntax for the border string is identical to that in SET BORDER. For more information, see SET BORDER.
Comment or report problem with topic