Build a print job, Starting a print job – Adobe Flash Professional CS3 User Manual
Page 464
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
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.