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.
If the user selects an option to begin printing, the PrintJob.start() method returns a value of true. (The value is false if the user cancels the print job, in which case the script should call only delete). If successful, the PrintJob.start() method sets values for the paperHeight, paperWidth, pageHeight, pageWidth, and orientation properties.
Depending on the user’s operating system, an additional dialog box might appear until spooling is complete and the PrintJob.send function is called: Make calls to PrintJob.addPage() and PrintJob.send() expeditiously. If ten seconds elapse between the PrintJob.start() function call and the PrintJob.send() function call, which sends the print job to the printer, Flash Player effectively calls PrintJob.send(), causing any pages that are added by using PrintJob.addPage() to be printed and spooling to stop.
When a new print job is constructed, the PrintJob() properties are initialized to 0. When PrintJob.start() is called, after the user selects the print option in the operating system print dialog box, Flash Player retrieves the print settings from the operating system. The PrintJob.start() function populates the following properties:
|
Property |
Type |
Unit |
Notes |
|---|---|---|---|
|
PrintJob.paperHeight |
number |
points |
Overall paper height |
|
PrintJob.paperWidth |
number |
points |
Overall paper width |
|
PrintJob.pageHeight |
number |
points |
Height of actual printable area on the page; does not include any user-set margins |
|
PrintJob.pageWidth |
number |
points |
Width of actual printable area on the page; does not include any user-set margins |
|
PrintJob.orientation |
string |
n/a |
Portrait or landscape orientation |