drawbox:

Format:

drawbox: Rv | trow, Rw | tcol, Rx | brow, Ry | bcol, Rz | "format"

drawbox: will draw a box on the screen using the supplied format string. The area inside the box is cleared when the box is drawn. The upper left corner of the box is defined as trow, tcol, and the bottom right corner of the box is defined as brow, bcol. The format string is a set of 6 characters that define the box or one of 8 predefined macros.

Format String

The format string contains six characters that define the box: tl, tr, bl, br, tb, side.

tl = top left corner character.
tr = top right corner character.
bl = bottom left corner character.
br = bottom right corner character.
tb = top and bottom line character.
side = the left and right side character.

Format Macros

There are seven predefined box style macros that can be used instead of a format string. Note that the macros must be enclosed in quotes if not contained within a register. The defined macros:

1. "box1" = a single line box.
2. "box2" = a double line box.
3. "box3" = a double-single line box.
4. "boxa" = an ascii box.
5. "boxs1" = a solid box style 1.
6. "boxs2" = a solid box style 2.
7. "boxs3" = a solid box style 3.
8. "boxs4" = a solid box style 4.

See drawbox.ata for an example on useage and the different box styles.

Parameters:

Rv | trow: A numeric register or constant that defines the upper left row of the box.
Rw| tcol: A numeric register or constant that defines the upper left column of the box.
Rx | brow: A numeric register or constant that defines the bottom right row of the box.
Ry | bcol: A numeric register or constant that defines the bottom right column of the box.
Rz | "format": A string register or constant that defines the box format or contains a style macro.