PrintRoundRect PowerScript function
Description
Draws a white rectangle with rounded corners and a border
of the specified thickness on the print page.
Syntax
1 |
<span>PrintRoundRect</span> ( <span>printjobnumber</span>, <span>x</span>, <span>y</span>, <span>width</span>, <span>height</span>, <span>xradius</span>, <span>yradius</span>,<br>   <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 |
xradius |
An integer specifying the x radius of |
yradius |
An integer specifying the y radius of |
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, PrintRoundRect 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.
PrintRoundRect 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
This example starts a new print job, which begins
a new page, and prints a rectangle with rounded corners as a page
border. Then it closes the print job, which sends the page to the
printer.
The rectangle is 6 1/4 inches wide by 9 inches high
and its upper corner is one inch from the top and one inch from
the left edge of the print area. The border has a line thickness
of 1/8 of an inch and the corner radius is 300:
1 |
long Job |
1 |
1 |
// Define a new blank page. |
1 |
Job = PrintOpen() |
1 |
1 |
// Print a RoundRectangle on the page. |
1 |
<span>PrintRoundRect</span>(Job, 1000,1000, 6250,9000, & |
1 |
   300,300, 125) |
1 |
1 |
// Send the page to the printer. |
1 |
PrintClose(Job) |