Adobe 38039481 User Guide - Page 463

FLASH CS3 457 User Guide 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 Because you are spooling a print job to the user's operating system between your calls to the PrintJob.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, complete formatting of your print job, add pages to the print 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; } Only one print job can run at any given time. A second print job cannot be created until one of the following events 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.