
FLASH CS3
User Guide
458
Additionally, with properties populated by the PrintJob.start()method, your document can access your user’s
printer settings, such as page height, width, and orientation, and you can configure your document to dynamically
format Flash content that is appropriate for the printer settings.
Build a print job
Becauseyouarespoolingaprintjobtotheuser’soperatingsystembetweenyourcallstothePrintJob.start() and
PrintJob.send() methods, and because the PrintJob functions might temporarily affect the Flash Player internal
view of onscreen Flash content, 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,completeformattingofyourprintjob,addpagestotheprint
job, and send the print job to the printer.
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().
3 Add pages to the print job (call once per page to add to the print job): PrintJob.addPage().
4 Send the print job to the printer: PrintJob.send().
5 Delete the print job: delete PrintJob.
The following example shows ActionScript code 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;
}
Onlyoneprintjobcanrunatanygiventime.Asecondprintjobcannotbecreateduntiloneofthefollowingevents
occurs with the previous print job:
• The print job is entirely successful and the PrintJob.send() method is called.
• The PrintJob.start() method returns a value of false.
• The PrintJob.addPage() method returns a value of false.
• The delete PrintJob method is called.
Note: For information on printing from SWF files at runtime using ActionScript 3.0, see “Printing” in Programming
ActionScript 3.0.
Starting a print job
Calling the ActionScript 2.0 PrintJob.start() method spools the print job to the user’s operating system and
prompts the user’s operating system print dialog box to appear.
Comentários a estes Manuais