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

hpIGrayBox()*

Draw a gray shaded box with one of several different line types, coordinates
specified in inches


Syntax

hpIGrayBox(<nTop>, <nLeft>, <nBottom>, <nRight> [,<nBorder> [,<nShade>]])


Parameters

<Top>
The distance from the top margin to draw the top side of
the box.  <Top> is specified in inches.

<nLeft>
The distance from the left margin to draw the left side of
the box.  <nLeft> is specified in inches.

<nBottom>
The distance from the top margin to draw the bottom
side of the box.  <nBottom> is specified in inches.

<nRight>
The distance from the left margin to draw the right side
of the box.  <nRight> is specified in inches.

<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.
There are eight shading levels.  To specify a shade use
any value from 1 to 100.  If omitted, <nShade> will
default to 10.  See "Appendix B - Shades and Fill
Patterns" for a description of the different shading
levels.


Returns

0
Successful.

-12
Wrong number of parameters passed.

-14
Box coordinates specified in wrong order.


Remarks

hpIGrayBox() is included for compatibility with earlier versions of
Escape!. The use of hpIGrayBox() is not recomended because it can be
functionally replaced by hpGrayBox() with 'I' (for Inches) passed as the
<cUnits> parameter.

Use hpIGrayBox() whenever you want to highlight sections of your page
such as totals, or when creating custom charts or forms.  Use
hpIGrayBox(), along with hpIAtSay() when printing with proportional
fonts.

hpIGrayBox() can also be used to print lines.  With hpIGrayBox(), you
can create lines of whatever thickness you desire.


Support By

All HP Laser Printers except the original HP Laserjet


Example

To print a 2 inch square gray box with a double line border and 20
percent gray shading:

hpIGrayBox(1, 1, 3, 3, 2, 20)

To print a 1/8th inch thick line, 10 inches down on the page and 7 inches
long:

nWidth = 1/8
hpIGrayBox(10, 1, 10 + nWidth, 8, 0, 100)

To print the same type of line on the 10th row of your printout use
hpL2I():

hpIGrayBox(hpL2I(10), 1, hpL2I(10) + (1/8), 8, 0, 100)