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

hpGrayBox()

Draw a gray shaded box with one of several different border types


Syntax
hpGrayBox(<nTop>, <nLeft>, <nBottom>, <nRight> [,<nBorder> ;
   [,<nShade> [,<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

<nShade>
The percent of gray shading used to fill the bar with.
Defaults to 10%.  There are eight shading levels.  To
specify a shade use any value from 1 to 100.  See
"Appendix B - Shades and Fill Patterns" for a
description of the different shading levels.

<cUnits>
The units of measurement to used for positioning.
Defaults to 'R'.  Values for <cUnits> 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
Box coordinates specified in wrong order.


Remarks

Use hpGrayBox() whenever you want to highlight sections of your page
such as totals, or when creating custom charts or forms.

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


Support By

All HP Laser Printers except the original HP Laserjet


Example

To print a gray shaded box with a double line border:

@ 10,10 SAY 'This text is surrounded'
@ 11,10 SAY 'by a gray shaded box'
hpGrayBox(9, 9, 12, 33, 2)

To print a completely black box, 10 rows high and 10 columns wide:

hpGrayBox(1, 1, 10, 10, 0, 100)