Click above to get retro games delivered to your door ever month!

hpBox()

Draw boxes with one of several different line types


Syntax

hpBox(<nTop>, <nLeft>, <nBottom>, <nRight> [,<nBorder> [,<cUnits>]])


Parameters

<nTop>
The top row of the box.

<nLeft>
The left column of the box.

<nBottom>
The bottom row of the box.

<nRight>
The right column of the box.

<nBorder>
The line type used for the border.  Defaults to 1.  Values
can be:
0       No border
1       Single line
2       Double line
3       Dotted line
4       Hairline
5       0.5 point
6       1 point
7       2 point
8       3 point
9       4 point
10      6 point
11      8 point

<cUnits>
The units of measurement to used for positioning.
Defaults to 'R'.  Values can be:
"R"     Rows and Columns
"I"     Inches
"M"     Millimeters


Returns

0
Successful.

-10
Font information is missing. hpSetFont( ) must be called first.

-12
Wrong number of parameters passed.

-14
Incorrect box parameters.

-17
Incorrect parameter type was passed.


Remarks

If <nTop> and <nBottom> define the same row coordinates, Escape!
draws a horizontal line.  If <nLeft> and <nRight> define the same
column coordinates, Escape! draws a vertical line.  Use hpBox() to draw
lines and boxes anywhere on the page regardless of what pitch or line
spacing your printer is configured for.

Note:  Use hpIBox() when using a proportional font.


Support By

All HP Laser Printers except the original HP Laserjet


Example

hpBox(10,10,12,40)
@ 11,12 SAY "This text is inside the box"

hpBox(1,0,1,40,1)    // draws a horizontal line

hpBox(1,10,40,10,2)  // draws a vertical double line

hpBox(1,0,1,40,3)    // draws a horizontal dotted line