PrintRoundRect

Description

Draws a white rectangle with rounded corners and a border of the specified thickness on the print page.

Syntax

PrintRoundRect ( printjobnumber, x, y, width, height, xradius, yradius, thickness )

Argument

Description

printjobnumber

The number the PrintOpen function assigned to the print job

x

An integer specifying the x coordinate in thousandths of an inch of the upper-left corner of the rectangle

y

An integer specifying the y coordinate in thousandths of an inch of the upper-left corner of the rectangle

width

An integer specifying the rectangle's width in thousandths of an inch

height

An integer specifying the rectangle's height in thousandths of an inch

xradius

An integer specifying the x radius of the corner rounding

yradius

An integer specifying the y radius of the corner rounding

thickness

An integer specifying the thickness of the rectangle's border line in thousandths of an inch


Return value

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:

long Job
 
// Define a new blank page.
Job = PrintOpen()
 
// Print a RoundRectangle on the page.
PrintRoundRect(Job, 1000,1000, 6250,9000, &
   300,300, 125)
 
// Send the page to the printer.
PrintClose(Job)

See also

PrintBitmap

PrintClose

PrintLine

PrintOpen

PrintOval

PrintRect