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

hpGrayCol()

Draw a vertical, gray shaded bar


Syntax

hpGrayCol(<nRow>, <nCol>, <nLength> [,<nBorder> [,<nShade> [,<cUnits>]]])


Parameters

<nRow>
The row where the bar is to begin at.

<nCol>
The column where the bar will be drawn.

<nLength>
The length of the bar specified by number of rows.

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

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


Remarks

Use hpGrayCol() to emphasize a column of numbers, or to divide
sections of your report.  Try combining hpGrayCol() with any of the other
graphic functions to get some very impressive results.

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


Support By

All HP Laser Printers except the original HP Laserjet


Example

The command to fill the second column of your page with a gray shade
starting at row 5, surrounded by a single line, and extending down for
10 rows is:

hpGrayCol(5, 2, 10)