User Guide

print() 691
print()
Availability
Flash Player 4 (4.0.20.0)
Note: If you are authoring for Flash Player 7 or later, you can create a PrintJob object, which gives
you (and the user) more control over the printing process. For more information, see the PrintJob
class entry.
Usage
print(target:Object, "Bounding box":String) : Void
Parameters
target
The instance name of a movie clip to print. By default, all the frames in the target
instance can be printed. If you want to print specific frames in the movie clip, assign a
#p frame
label to those frames.
Bounding box A modifier that sets the print area of the movie clip. Enclose this parameter in
quotation marks (" or '), and specify one of the following values:
• bmovie Designates the bounding box of a specific frame in a movie clip as the print area for
all printable frames in the movie clip. Assign a
#b frame label to the frame whose bounding box
you want to use as the print area.
• bmax Designates a composite of all the bounding boxes of all the printable frames as the print
area. Specify
bmax when the printable frames in your movie clip vary in size.
• bframe Indicates that the bounding box of each printable frame should be used as the print
area for that frame, which changes the print area for each frame and scales the objects to fit the
print area. Use
bframe if you have objects of different sizes in each frame and want each object
to fill the printed page.
Returns
None.
Description
Function; prints the target movie clip according to the boundaries specified in the parameter
(
bmovie, bmax, or bframe). If you want to print specific frames in the target movie clip, attach a
#p frame label to those frames. Although print() results in higher quality prints than
printAsBitmap(), it cannot be used to print movie clips that use alpha transparencies or special
color effects.
If you use
bmovie for the Bounding box parameter but do not assign a #b label to a frame,
the print area is determined by the Stage size of the loaded movie clip. (The loaded movie clip
does not inherit the main movie clip’s Stage size.)
All the printable elements in a movie clip must be fully loaded before printing can begin.
The Flash Player printing feature supports PostScript and non-PostScript printers. Non-
PostScript printers convert vectors to bitmaps.
CHAPTER 2
ActionScript Language Reference