PrintRect PowerScript function
Description
Draws a white rectangle with a border of the specified thickness
on the print page.
Syntax
|
1 |
<span>PrintRect</span> ( <span>printjobnumber</span>, <span>x</span>, <span>y</span>, <span>width</span>, <span>height</span>, <span>thickness</span> ) |
|
Argument |
Description |
|---|---|
|
printjobnumber |
The number the PrintOpen function |
|
x |
An integer specifying the x coordinate |
|
y |
An integer specifying the y coordinate |
|
width |
An integer specifying the rectangle’s |
|
height |
An integer specifying the rectangle’s |
|
thickness |
An integer specifying the thickness of |
Return Values
Integer. Returns 1 if it succeeds and
-1 if an error occurs. If any argument’s value is null, PrintRect returns null.
Usage
The PrintOval, PrintRect,
and PrintRoundRect functions draw filled shapes.
To print other shapes or text inside the shapes, draw the filled
shape first and then add text and other shapes or lines inside it.
If you draw the filled shape after other printing functions, it
will cover anything inside it. For example, to draw a border around
text and lines, draw the oval or rectangular border first and then
use PrintLine and PrintText to
position the lines and text inside.
PrintRect does not change the position of the print cursor,
which remains where it was before the function was called. In general,
print functions in which you specify coordinates do not affect the
print cursor.
Examples
These statements open a print job with a new page
and draw a 1-inch square with a line thickness of 1/8 of
an inch. The square’s upper left corner is four inches
from the left and three inches from the top of the print area:
|
1 |
long Job |
|
1 |
// Define a new blank page. |
|
1 |
Job = PrintOpen() |
|
1 |
// Print the rectangle on the page. |
|
1 |
<span>PrintRect</span>(Job, 4000,3000, 1000,1000, 125) |
|
1 |
... // Other printing |
|
1 |
PrintClose(Job) |