Printjob.start() - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

PrintJob.start()

Availability
Flash Player 7.
Usage
my_pj.start() : Boolean
Parameters
None.
Returns
A Boolean value:
clicks Cancel or if an error occurs.
Description
Method; displays the operating system's print dialog boxes and starts spooling. The print dialog
boxes let the user change print settings. When the
successfully, the following read-only properties are populated, representing the user's print
settings:
Property
PrintJob.paperHeight
PrintJob.paperWidth
PrintJob.pageHeight
PrintJob.pageWidth
PrintJob.orientation
For more information, see "Specifying a print area (when not using the PrintJob object)" in Using
Flash.
After the user clicks OK in the Print dialog box, the player begins spooling a print job to the
operating system. You should issue any ActionScript commands that affect the printout, and you
can use PrintJob.addPage()
height, width, and orientation properties this method populates to format the printout.
Because the user sees information such as "Printing page 1" immediately after clicking OK, you
should call the
PrintJob.addPage()
If this method returns
operating system's Print dialog box), any subsequent calls to
PrintJob.send()
PrintJob.addPage()
sure the print spooler is cleared, as shown in the following example:
var my_pj:PrintJob = new PrintJob();
704 Chapter 2: ActionScript Language Reference
if the user clicks OK when the print dialog boxes appear;
true
Type
Number
Number
Number
Number
String
commands to send pages to the spooler. You can use the read-only
and
(for example, if the user clicks Cancel instead of OK in the
false
will fail. However, if you test for this return value and don't send
commands as a result, you should still delete the PrintJob object to make
PrintJob.start()
Units Notes
Points Overall paper height.
Points Overall paper width.
Points Height of actual printable area on the
page; any user-set margins are ignored.
Points Width of actual printable area on the
page; any user-set margins are ignored.
N/A "Portrait" or "landscape."
commands as soon as possible.
PrintJob.send()
PrintJob.addPage()
if the user
false
method returns
and