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

hpPattCol()

Draw a vertical bar filled with one of several different fill patterns


Syntax

hpPattCol(<nRow>, <nCol>, <nLength> [,<nBorder> [,<nPattern>]])


Parameters

<nRow>
The starting 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

<nPattern>
Specifies the type of fill pattern used to draw the bar.
There are six different fill patterns to choose from.  To
specify a pattern use any value from 1 to 6.  If omitted,
<nPattern> will default to pattern 1. See "Appendix B -
Shades and Fill Patterns" for a description of the
available patterns.

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

-17
Invalid parameter type was passed.


Remarks

hpPattCol() is useful for adding visual interest to custom forms.

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


Support By

All HP Laser Printers except the original HP Laserjet


Example

hpPattCol(1,1,23)      // pattern 1/single border

hpPattCol(1,1,23,0)    // pattern 1/no border

hpPattCol(1,1,23,3,4)  // pattern 4/dotted border