User Guide

Building a print job 377
Because you are spooling a print job to the user’s operating system between your calls to
PrintJob.start() and PrintJob.send(), and because the PrintJob functions might
temporarily affect the Flash Player internal view of onscreen Flash content, you should implement
print-specific activities only between your calls to
PrintJob.start() and PrintJob.send().
For example, the Flash content should not interact with the user between
PrintJob.start()
and
PrintJob.send(). Instead, you should expeditiously complete formatting of your print job,
add pages to the print job, and send the print job to the printer.
To build a print job:
1. Create an instance of the print job object: new PrintJob().
2. Start the print job and display the print dialog box for the operating system:
PrintJob.start(). For more information, see “Starting a print job” on page 378.
3. Add pages to the print job (call once per page to add to the print job): PrintJob.addPage().
For more information, see “Adding pages to a print job” on page 378.
4. Send the print job to the printer: PrintJob.send(). For more information, see “Sending the
print job to the printer” on page 381.
5. Delete the print job: delete PrintJob. For more information, see “Deleting the print job”
on page 381.
The following example shows ActionScript that creates a print job for a button:
myButton.onRelease = function()
{
var my_pj = new PrintJob();
var myResult = my_pj.start();
if(myResult){
myResult = my_pj.addPage (0, {xMin : 0, xMax: 400, yMin: 0,
yMax: 400});
myResult = my_pj.addPage ("myMovieClip", {xMin : 0, xMax: 400,
yMin: 400, yMax: 800},{printAsBitmap:true}, 1);
myResult = my_pj.addPage (1, null,{printAsBitmap:false}, 2);
myResult = my_pj.addPage (0);
my_pj.send();
}
delete my_pj;
}
Only one print job can run at any given time. A second print job cannot be created until one of
the following events has happened with the previous print job:
• The print job was entirely successful and PrintJob.send() method was called.
• The PrintJob.start() method returned a value of false.
• The PrintJob.addPage() method returned a value of false.
• The delete PrintJob method has been called.