home
***
CD-ROM
|
disk
|
FTP
|
other
***
search
/
Share Gallery 1
/
share_gal_1.zip
/
share_gal_1
/
UT
/
UT214.ZIP
/
SEBFU40.LZH
/
BOX.DOC
< prev
next >
Wrap
Text File
|
1991-09-01
|
9KB
|
295 lines
B O X Ver. 4.0
(C)1989,1990,1991 Scanlon Enterprises
BOX is a utility to draw boxes on the video display. The boxes
can be draw using a variety of line drawing characters. This
utility is useful for highlighting special comments or
information on the screen. The box is drawn starting at the
current cursor location.
Syntax : BOX /Ln /Wn /Fn /Bn /Pn /Gn /D /R
ERRORLEVELS: 0FF (255) Program Problem (call Author)
002 Bad option/parameter
000 OK
Where : '/Ln' The box will be drawn using 'n' number of lines.
'/Wn' The box will be drawn using 'n' columns.
'/Fn' The box will be drawn using 'n' foreground color.
'/Bn' The box will be drawn using 'n' Background color.
'/Pn' The box will be drawn using 'n' video page.
'/Gn' The box will be drawn using 'n' character. If 'n'
is a single character, then that character will
be the graphics character. If 'n' is more than 1
character, they must be decimal values, and the
ascii value of the decimal string will become the
box character. To produce box character for ascii
values of single digits, simply precede the ascii
value by a zero, thus, a '1' becomes '01'!
'/D' The box will be drawn using double line graphics
characters instead of the default single line
graphics characters.
'/R' The box will be drawn using DOS instead of the
video bios.
Defaults: Single line graphics are used to draw the box
unless either the '/D' or '/Gn' switch is
specified.
The Box will be drawn using 3 video lines and
4 video columns unless the '/Wn' and '/Ln' options
are specified.
The Box will be drawn using the current video
colors unless the '/Fn' and '/Bn' are specified.
For values of 'n' in color specification, please
read the COLOR.DOC file.
The box will be drawn on the current active video
page unless the '/Pn' option is specified. The box
will be invisible untill the user changes video
pages using our GSMODE utility or other utility
which can change the video page.
The box will be drawn using the video Bios unless
the '/R' option is specified.
Page 1 of 5
B O X Ver. 4.0
(C)1989,1990,1991 Scanlon Enterprises
USAGE : BOX
Draws a box starting at the current cursor location, and
extending three lines below, and 4 columns over. IE... if the
cursor is on line 1 column 1 the box will be drawn using lines 1
thru 3 and columns 1 thru 4. The box will look like this:
┌──┐
│ │ {This will be drawn using standard ascii
└──┘ characters if your printer or text viewing
system does NOT support extended characters}
The box will be drawn using the current video color (usually
white on black).
BOX /L2
The box will be drawn as in the first usage, but will be 1 line
longer (lines 1 thru 4).
BOX /L2 /W3
The box will be drawn as in the previous usage, execpt the box
will be one column longer (using lines 1 thru 4 and columns 1
thru 5).
BOX /F7
The box will be drawn as in the first usage, except the box
will be drawn using white, as the foreground color.
BOX /F7 /F1
The box will be drawn as in the first usage, except the box will
be drawn using white on blue. The middle of the box is left
untouched.
BOX /P2
The box will be drawn as in the first usage, but will be drawn on
video page 2, which may NOT be the current active page, thus may
be invisible. Use our GSMODE to change the video page.
Page 2 of 5
B O X Ver. 4.0
(C)1989,1990,1991 Scanlon Enterprises
BOX /G*
The box will be drawn as in the first usage, except the box will
be drawn using the '*' instead of single line graphics.
BOX /D
The box will be drawn as in the first usage, except the box
will be drawn using double line graphics.
BOX /R
The box will be drawn as in the first usage, except the box may
be redirected to a file or printer.
EXAMPLES:
ECHO OFF
CLS
LOCATE 3 5
ECHO Hello
LOCATE 2 4
BOX /W5
LOCATE 5 1
This example will draw a box around the word hello, which was
displayed using the DOS ECHO command. LOCATE is one of the SEBFU
utilities which positions the cursor. The first usage was to
position the cursor on line 3, column 5 (LOCATE 3 5). The second
usage was to position the cursor on line 2, column 4.
To create this short little batch file, enter :
COPY CON BOXTEST.BAT {at a DOS prompt}
Next, enter each of the above lines (below example, starting with
the line ECHO OFF, and ending with the line LOCATE 5 1). Making
sure that the cursor is on a new line, hold the control key down,
and press the key labeled 'z', then release both keys. Your
screen will display the string '^Z', now press the ENTER key. DOS
will then display the message :
ONE FILE COPIED
Now enter BOXTEST at the DOS prompt. A box with Hello should be
displayed at the top right of your display.
Page 3 of 5
B O X Ver. 4.0
(C)1989,1990,1991 Scanlon Enterprises
EXAMPLES: {continued}
ECHO OFF
CLS
LOCATE 3 5
ECHO Press the ESC key to abort
LOCATE 4 5
ECHO Press the SPACE key to continue
LOCATE 2 15
BOX /L2 /W5 /F7 /B1
LOCATE 7 1
This example shows how you can make a box around text spaning
multilple lines. Here the box will only be drawn around the word
ESC on line 3 and SPACE on line 4. Use the same process as
described in the previous example to try this.
Redo the above example but add the switch '/D' to the end of the
line containing the BOX command.
BOX /L2 /W5 /F7 /B1 /D
This will produce the same box, using double line graphics
instead of single line graphics.
For additional usage and information on using these utilities see
the file SEBFU.DOC or BATUT.DOC.
Page 4 of 5
B O X Ver. 4.0
(C)1989,1990,1991 Scanlon Enterprises
O R D E R F O R M
BOX registration ........................................ $1.50
What you get :
Unlimited usage of BOX, and phone or write in support. You will
also be placed on our mailing list for future updates and new
products.
We are offering this utility seperate from SEBFU as a favor to
users who do NOT wish to use many of the SEBFU utilities.
This utility is automatically registered to you when you register
SEBFU as a product (see REG.DOC). Registering SEBFU as a product
is a better bargin, as each utility will cost less than $ .25
each.
Vendors:
You may distribute BOX seperately, provided this document is
distributed as well. Any reasonable fee may be charged.
Send your order to : SCANLON ENTERPRISES
38354 17TH ST E.
PALMDALE, CA 93550