MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference page 700

•
If the content that you're printing includes a bitmap image, use
include any transparency and color effects.
•
If the content does not include bitmap images, omit this parameter or use
{printAsBitmap:false}
If is omitted or is passed incorrectly, vector printing is used. If you don't want to specify
options
a value for
options
frameNumber
does not cause the ActionScript on that frame to be invoked. If you omit this
frameNumber
parameter, the current frame in
Note: If you previously used
from Flash, you might have used a
To use
PrintJob.addPage()
for each frame;
#p
section.
Returns
A Boolean value:
Description
Method; sends the specified level or movie clip as a single page to the print spooler. Before using
this method, you must use PrintJob.start(); after calling
for a print job, you must use
If this method returns
canceled the print job), any subsequent calls to
previous calls to
command sends the successfully spooled pages to the printer.
If you passed a value for
(0,0 coordinates) of the printable area on the page. The user's printable area is described by the
read-only
pageHeight
printout aligns with the upper left corner of the printable area on the page, the printout is clipped
to the right and/or bottom if the area defined in
the page. If you haven't passed a value for
area, the same type of clipping takes place.
For more information, see "Specifying a print area (when not using the PrintJob object)" in Using
Flash.
If you want to scale a movie clip before you print it, set its
MovieClip._yscale
values afterward. The scale of a movie clip has no relation to
that you print an area that is 50 x 50 pixels in size, 2500 pixels are printed. If you have scaled the
movie clip, the same 2500 pixels are printed, but the movie clip is printed at the scaled size.
The Flash Player printing feature supports PostScript and non-PostScript printers. Non-
PostScript printers convert vectors to bitmaps.
700 Chapter 2: ActionScript Language Reference
to print the content in higher quality vector format.
but want to specify a value for
An optional number that lets you specify which frame to print; passing a
target
,
print() printAsBitmap()
frame label on multiple frames to specify which pages to print.
#p
to print multiple frames, you must issue a
frame labels are ignored. For one way to do this programmatically, see the Example
if the page is successfully sent to the print spooler;
true
PrintJob.send()
(for example, if you haven't called
false
PrintJob.addPage()
, the
printArea
and
pageWidth
properties before calling this method, and set them back to their original
frameNumber
is printed.
,
printAsBitmapNum()
PrintJob.addPage()
to send the spooled pages to the printer.
PrintJob.addPage()
were successful, the concluding
and coordinates map to the upper left corner
xMin yMin
properties set by
PrintJob.start()
is bigger than the printable area on
printArea
and the Stage is larger than the printable
printArea
MovieClip._xscale
printArea
{printAsBitmap:true}
, pass for
null options
, or
printNum()
PrintJob.addPage()
otherwise.
false
one or more times
or the user
PrintJob.start()
will fail. However, if
PrintJob.send()
. Because the
and
. That is, if you specify
to
.
to print
command