Starting A Print Job - MACROMEDIA FLASH MX 2004-USING FLASH Use Manual

Starting a print job

Calling the
PrintJob.start()
operating system and also prompts the user's operating system print dialog box to appear.
If the user selects an option in the print dialog box to begin printing, the
method returns a value of
case the script should call only
for the
paperHeight
Depending on the user's operating system, an additional dialog box might appear until spooling is
complete and the function
PrintJob.send()
PrintJob.start()
job to the printer, Flash Player effectively calls
added using
PrintJob.addPage()
When a new print job is constructed, the
PrintJob.start()
dialog box, Flash Player retrieves the print settings from the operating system. The
PrintJob.start()
Property
PrintJob.paperHeight
PrintJob.paperWidth
PrintJob.pageHeight
PrintJob.pageWidth
PrintJob.orientation
Note: A point is a print unit of measurement that is equal in size to one pixel, a screen unit of measure.
For more information about unit equivalencies, see
Adding pages to a print job
You add pages to your print job with the
can include as many as four parameters, the only required parameter is
optional parameters are
If you are not using a particular optional parameter but are using other optional parameters, use
in place of the excluded optional parameter.
NULL
With all four parameters, the function uses the following syntax:
MyPrintJob.addPage(target[,printArea:Object, options:Object,
frameNum:Number]):boolean;
If you provide an invalid parameter, the print job uses default parameter values, which are
specified in the following sections.
378 Chapter 18: Printing from SWF Files
method prompts Flash Player to spool the print job to the user's
. (The value is
true
). If successful, the
delete
, ,
paperWidth pageHeight
PrintJob.send
should be made expeditiously. If ten seconds elapse between the
function call and the
to be printed and spooling to stop.
is called, after the user selects the print option in the operating system print
function populates the following properties:
Type
number points
number points
number points
number points
string
,
printArea options
if the user cancels the print job, in which
false
PrintJob.start()
, , and
pageWidth
is called: Calls to
PrintJob.addPage()
function call, which sends the print
PrintJob.send()
PrintJob.send()
properties are initialized to 0. When
PrintJob()
Unit Notes
Overall paper height.
Overall paper width
Height of actual printable area on the page;
does not include any user-set margins
Width of actual printable area on the page;
does not include any user-set margins
n/a Portrait or landscape orientation
"About scaling" on page
PrintJob.addPage()
, and .
frameNum
PrintJob.start(
method sets values
properties.
orientation
and
, causing any pages that are
380.
method. Although the method
. The three
target/level
)