Syntax 2 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
|
DataWindow type |
Method applies to |
|---|---|
|
PowerBuilder |
DataWindow control |
Syntax
PowerBuilder
|
1 |
integer objectname.Print ( long printjobnumber, integer x, integer y {, integer width, integer height } ) |
|
Argument |
Description |
|---|---|
|
objectname |
The name of the object that you want to print. The |
|
printjobnumber |
The number the PrintOpen function assigns to the |
|
x |
An integer whose value is the x coordinate on the |
|
y |
An integer whose value is the y coordinate on the |
|
width (optional) |
An integer specifying the printed width of the |
|
height (optional) |
An integer specifying the printed height of the |
Return value
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, you must call the PrintOpen
function and the PrintClose or PrintCancel functions yourself to manage
the process. For more information, see PowerScript Reference.
Print area and margins
The print area is the physical page size minus any margins in
the printer itself. Depending on the printer, you may be able to
change margins using PrintSend and printer-defined escape
sequences.
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
Print in the section called “Print” in PowerScript Reference
PrintClose in the section called “PrintClose” in PowerScript Reference
PrintOpen in the section called “PrintOpen” in PowerScript Reference
PrintScreen in the section called “PrintScreen” in PowerScript Reference