|Purpose:||Draw a box on the screen|
|Format:||DRAWBOX ulrow ulcol lrrow lrcol style [BRIght] fg ON [BRIght] bg [FILL [BRIght] bgfill] [ZOOm] [SHAdow]|
|ulrow||Row for upper left corner|
|ulcol||Column for upper left corner|
|lrrow||Row for lower right corner|
|lrcol||Column for lower right corner|
|style||Box drawing style:|
|0||No lines (box is drawn with blanks)|
|3||Single line on top and bottom, double on sides|
|4||Double line on top and bottom, single on sides|
|fg||Foreground character color|
|bg||Background character color|
|bgfill||Background fill color (for the inside of the box)|
DRAWBOX is useful for creating attractive screen displays in batch files.
For example, to draw a box around the edge of an 80x25 window with bright white lines on a blue background:
drawbox 0 0 24 79 1 bri whi on blu fill blu
See Colors and Color Names for details about colors.
If you use ZOOM, the box appears to grow in steps to its final size. The speed of the zoom operation depends on the speed of your computer and video system.
If you use SHADOW, a drop shadow is created by changing the characters in the row under the box and the 2 columns to the right of the box to normal intensity text with a black background (this will make characters displayed in black disappear entirely).
The row and column values are zero-based, so on a standard 25 line by 80 column display, valid rows are 0 - 24 and valid columns are 0 - 79.
Numeric input may be entered in either decimal format (a sequence of 0-9 digits) or in hexadecimal format ("0x" followed by a sequence of 0-F hex digits). DRAWBOX checks for valid row and column values, and displays a "Usage" error message if any values are out of range.
The maximum row value is determined by the current height of the TCC window. The maximum column value is determined by the current virtual screen width (see Resizing the Take Command Window for more information).
If ulrow is set to 999, lrrow is assumed to be the desired height, and the box will be centered vertically. If ulcol is set to 999, lrcol is assumed to be the desired width, and the box will be centered horizontally.
Unlike DRAWHLINE and DRAWVLINE, DRAWBOX does not automatically connect boxes to existing lines on the screen with the proper connector characters. If you want to draw lines inside a box and have the proper connectors drawn automatically, draw the box first, then use DRAWHLINE and DRAWVLINE to draw the lines.
DRAWBOX uses the standard line and box drawing characters in a Unicode or U.S. English extended ASCII character set. If you use an ASCII or raster font which does not include these line drawing characters, the box or lines will not be displayed correctly.