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

hpIAtSay()*

Print a character string anywhere on the page with position specified in
inches


Syntax

hpIAtSay(<nRow>, <nCol>, <cString>)


Parameters

<nRow>
The vertical distance from the top margin to print the
specified string specified in inches.

<nCol>
The horizontal distance from the left margin to print the
string specified in inches.

<cString>
The character string to print.


Returns

0
Successful.

-12
Wrong number of parameters passed.


Remarks

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

hpIAtSay() is similar to hpAtSay() except here, row and column
coordinates are specified in inches. hpIAtSay() can be used to print a
character string anywhere on the page, regardless of row position,
without any worry of page ejects.

Usually, when printing reports, you would use hpAtSay() because with
this function, text position is specified in the familiar row/column format.
What hpIAtSay() is useful for is anytime you need to place a string at
some precise position on the page.  For example, it is often easier to
place footers, legends, page numbers, etc., at some exact location by
measuring the desired distance with a ruler, rather than counting
characters.  You could then use hpIAtSay() to display your text.  Also,
see how hpIAtSay() can help you print with proportional fonts in the
example below.


Support By

All HP Laserjet Printers


Example

Now, with hpIAtSay(), you have the ability to line up proportional fonts:
hpPrintOn()

hpConfig('LEGAL')
hpSetFont('TMSRMN 8', 'K')
line := 1
DO WHILE .NOT. EOF()
.
.
.

Suppose you need to print a name exactly 3 inches down on the page,
and 2 inches across (ie. when printing on forms).  With hpIAtSay(), you
can accomplish this quite easily:
hpIAtSay(3, 2, 'Name')

If you need to get very exact placement, you can even specify inches
down to two decimal places:
hpIAtSay(3.26, 2.74, 'Name')