Printjob.addpage() - MACROMEDIA FLASH MX 2004-ACTIONSCRIPT LANGUAGE Reference

PrintJob.addPage()

Availability
Flash Player 7.
Usage
my_pj.addPage(target:Object [, printArea:Object] [, options:Object ] [,
frameNumber:Number]) : Boolean
Parameters
A number or string; the level or instance name of the movie clip to print. Pass a number
target
to specify a level (for example, 0 is the
specify the instance name of a movie clip.
An optional object that specifies the area to print, in the following format:
printArea
{xMin:topLeft, xMax:topRight, yMin:bottomLeft, yMax:bottomRight}
The coordinates you specify for
point of the
_root
You must provide all four coordinates. The width (
each be greater than 0.
Points are print units of measurement, and pixels are screen units of measurement; points are a
fixed physical size (1/72 inch), but the size of a pixel depends on the resolution of the particular
screen. You can use the following equivalencies to convert inches or centimeters to twips or points
(a twip is 1/20 of a point):
•
1 point = 1/72 inch = 20 twips
•
1 inch = 72 points = 1440 twips
•
1 cm = 567 twips
You can't reliably convert between pixels and points; the conversion rate depends on the screen
and its resolution. If the screen is set to display 72 pixels per inch, for example, one point is equal
to one pixel.
Note: If you have previously used
print from Flash, you might have used a
method, you must use the
addPage()
are ignored.
If you omit the
printArea
printed. If you don't want to specify a value for
or
options frameNumber
An optional parameter that specifies whether to print as vector or bitmap, in the
options
following format:
{printAsBitmap:Boolean}
The default value is
bitmap, pass
true
which value to use:
_root
printArea
movie clip (if
target
,
print()
#b
printArea
parameter, or if it is passed incorrectly, the full Stage area of
, pass for
null
, which represents a request for vector printing. To print
false
for . Remember the following suggestions when determining
printAsBitmap
movie), or a string (in quotation marks [""]) to
represent screen pixels relative to the registration
= 0) or of the level or movie clip specified by
) and height (
xMax-xMin
,
printAsBitmap() printAsBitmapNum()
frame label to specify the area to print. When using the
parameter to specify the print area;
but want to specify a value for
printArea
.
printArea
target
) must
yMax-yMin
, or to
printNum()
frame labels
#b
target
as a
target
PrintJob.addPage() 699
.
is