DRAWVLINE

Print Topic  Return to Overview  Previous Topic  Next Topic 
Purpose:Draw a vertical line on the screen.

 

Format:DRAWVLINE row column len style [BRIght] fg ON [BRIght] bg

 

rowStarting row
columnStarting column
lenLength of line
styleLine drawing style:

1     Single line

2     Double line

fgForeground character color
bgBackground character color

 

See also:  DRAWBOX and DRAWHLINE.

 

Usage:

 

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).

 

For example, 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

 

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 (series of digits 0-9) 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 Resizing the Take Command Window for more information).

 

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.

Topic "drawvline.htm" last edited 1/27/2008. ©2008  JP Software, Inc.
Keywords: DRAWVLINE,DRAWHLINE