User Guide

700 Chapter 2: ActionScript Language Reference
• If the content that you’re printing includes a bitmap image, use {printAsBitmap:true} to
include any transparency and color effects.
• If the content does not include bitmap images, omit this parameter or use
{printAsBitmap:false} to print the content in higher quality vector format.
If
options is omitted or is passed incorrectly, vector printing is used. If you don’t want to specify
a value for
options but want to specify a value for frameNumber, pass null for options.
frameNumber An optional number that lets you specify which frame to print; passing a
frameNumber does not cause the ActionScript on that frame to be invoked. If you omit this
parameter, the current frame in
target is printed.
Note: If you previously used print(), printAsBitmap(), printAsBitmapNum(), or printNum() to print
from Flash, you might have used a
#p frame label on multiple frames to specify which pages to print.
To use
PrintJob.addPage() to print multiple frames, you must issue a PrintJob.addPage() command
for each frame;
#p frame labels are ignored. For one way to do this programmatically, see the Example
section.
Returns
A Boolean value: true if the page is successfully sent to the print spooler; false otherwise.
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
PrintJob.addPage() one or more times
for a print job, you must use PrintJob.send() to send the spooled pages to the printer.
If this method returns
false (for example, if you haven’t called PrintJob.start() or the user
canceled the print job), any subsequent calls to
PrintJob.addPage() will fail. However, if
previous calls to
PrintJob.addPage() were successful, the concluding PrintJob.send()
command sends the successfully spooled pages to the printer.
If you passed a value for
printArea, the xMin and yMin coordinates map to the upper left corner
(0,0 coordinates) of the printable area on the page. The user’s printable area is described by the
read-only
pageHeight and pageWidth properties set by PrintJob.start(). Because the
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
printArea is bigger than the printable area on
the page. If you haven’t passed a value for
printArea and the Stage is larger than the printable
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._xscale and
MovieClip._yscale properties before calling this method, and set them back to their original
values afterward. The scale of a movie clip has no relation to
printArea. That is, if you specify
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.