368
USING FLASH CS4 PROFESSIONAL
ActionScript
•
The
PrintJob.addPage()
method returns a value of
false
.
•
The
delete PrintJob
method is called.
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.
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:
Adding pages to a print job
You add pages to your print job with the ActionScript 2.0
PrintJob.addPage()
method. Although the method can
include as many as four parameters, the only required parameter is
target/level
. The three optional parameters are
printArea
,
options
, and
frameNum
.
If you are not using a particular optional parameter but are using other optional parameters, use
NULL
in place of the
excluded optional parameter.
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.
Each call to add a new page is unique, which lets you modify parameters without affecting previously set parameters.
For example, you can specify that one page print as a bitmap image and another page print as a vector graphic. You
can add as many new pages to your print job as the print job requires. One call to add a page equals one printed page.
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
Updated 5 March 2009