|Purpose:||Draw a vertical line on the screen|
|Format:||DRAWVLINE row column len style [BRIght] fg ON [BRIght] bg|
|len||Length of line|
|style||Line drawing style:|
|fg||Foreground character color|
|bg||Background character color|
See also: DRAWBOX and DRAWHLINE.
DRAWVLINE is useful for creating attractive screen displays in batch files. It detects other lines and boxes on the display, and creates the appropriate connector characters when possible (not all types of lines can be connected with the available characters).
The row and column values are zero-based, so on a 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). If either value is out of range, DRAWVLINE displays a "Usage" error message.
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 Colors and Color Names for details about colors.
DRAWVLINE 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.
To draw a double width line along the left margin of the display with bright red characters on a black background:
drawvline 0 0 25 2 bright red on black