Syntax 1: For printing a visual object in a print job
Description
Includes a visual object, such as a window or a graph control, in
a print job that you have started with the PrintOpen function.
Applies to
Any object
Syntax
|
1 |
objectname.Print ( printjobnumber, x, y {, width, height } ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the object that you want to print. The |
|
printjobnumber |
The number the PrintOpen function assigns to the print |
|
x |
An integer whose value is the x coordinate on the page |
|
y |
An integer whose value is the y coordinate on the page |
|
width (optional) |
An integer specifying the printed width of the object in |
|
height (optional) |
An integer specifying the printed height of the object |
Return value
Integer. Returns 1 if it succeeds and -1 if an error occurs. If
any argument’s value is null, Print returns null.
Usage
PowerBuilder manages print jobs by opening the job, sending data,
and closing the job. When you use Syntax 2 or 3, you must call the
PrintOpen function and the PrintClose or PrintCancel functions yourself
to manage the process.
PowerBuilder copies the area of the screen occupied by the control
to the printer. If any other window or application displays on the
screen in that area in front of the control while the control is being
printed, that window or application will also be printed.
Print area and margins
The print area is the physical page size minus any margins in the
printer itself.
Examples
This example prints the CommandButton cb_close in its original
size at location 500, 1000:
|
1 2 3 4 |
long Job Job = PrintOpen( ) cb_close.Print(Job, 500,1000) PrintClose(Job) |
This example opens a print job, which defines a new page, then
prints a title using the third syntax of Print. Then it uses this syntax
of Print to print a graph on the first page and a window on the second
page:
|
1 2 3 4 5 6 7 8 |
long Job Job = PrintOpen( ) Print(Job, "Report of Year-to-Date Sales") gr_sales1.Print(Job, 1000,PrintY(Job)+500, & 6000,4500) PrintPage(Job) w_sales.Print(Job, 1000,500, 6000,4500) PrintClose(Job) |
See also