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.

Controls

DataWindow type	Method applies to
PowerBuilder	DataWindow control

Syntax

[PowerBuilder]

integer <span>objectname</span><span>.Print </span>( long <span>printjobnumber</span>, integer <span>x</span>, integer <span>y </span>{, integer <span>width</span>, integer <span>height</span> } )

1	integer <span>objectname</span><span>.Print </span>( long <span>printjobnumber</span>, integer <span>x</span>, integer <span>y </span>{, integer <span>width</span>, integer <span>height</span> } )

Argument	Description
objectname	The name of the object that you want to print. The object must either be a window or an object whose ancestor type is DragObject, which includes all the controls that you can place in a window.
printjobnumber	The number the PrintOpen function assigns to the print job
x	An integer whose value is the x coordinate on the page of the left corner of the object, in thousandths of an inch.
y	An integer whose value is the y coordinate on the page of the left corner of the object, in thousandths of an inch.
width (optional)	An integer specifying the printed width of the object in thousandths of an inch. If omitted, PowerBuilder uses the object’s original width.
height (optional)	An integer specifying the printed height of the object in thousandths of an inch. If omitted, PowerBuilder uses the object’s original height.

Return Values

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 the 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:

long Job

long Job

Job = PrintOpen( )

1	Job = PrintOpen( )

cb_close.<span>Print</span>(Job, 500,1000)

1	cb_close.<span>Print</span>(Job, 500,1000)

PrintClose(Job)

1	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:

long Job

long Job

Job = PrintOpen( )

1	Job = PrintOpen( )

Print(Job, "Report of Year-to-Date Sales")

1	Print(Job, "Report of Year-to-Date Sales")

gr_sales1.<span>Print</span>(Job, 1000,PrintY(Job)+500, &amp;

1	gr_sales1.<span>Print</span>(Job, 1000,PrintY(Job)+500, &

        6000,4500)

1	6000,4500)

PrintPage(Job)

1	PrintPage(Job)

w_sales.<span>Print</span>(Job, 1000,500, 6000,4500)

1	w_sales.<span>Print</span>(Job, 1000,500, 6000,4500)

PrintClose(Job)

1	PrintClose(Job)

Syntax 2 For printing a visual object in a print job – PB Docs 126