MACROMEDIA FLEX-FLEX ACTIONSCRIPT LANGUAGE, Reference

Page: 392 / 830

392 Chapter 6: ActionScript Core Classes
Parameters
target
A number or string; the level or instance name of the movie clip to print. Pass a number
to specify a level (for example, 0 is the
_root
movie), or a string (in quotation marks [""]) to
specify the instance name of a movie clip.
printArea
An optional object that specifies the area to print, in the following format:
{xMin: topLeft , xMax: topRight , yMin: bottomLeft , yMax: bottomRight }
The coordinates you specify for
printArea
represent screen pixels relative to the registration
point of the
_root
movie clip (if
target
= 0) or of the level or movie clip specified by
target
.
You must provide all four coordinates. The width (
xMax-xMin
) and height (
yMax-yMin
) must
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.
If you omit the
printArea
parameter, or if it is passed incorrectly, the full Flex screen area of
target
is printed. If you don’t want to specify a value for
printArea
but want to specify a value
for
options
or
frameNumber
, pass
null
for
printArea
.
options
An optional parameter that specifies whether to print as vector or bitmap, in the
following format:
{printAsBitmap: Boolean }
The default value is
false
, which represents a request for vector printing. To print
target
as a
bitmap, pass
true
for
printAsBitmap
. Remember the following suggestions when determining
which value to use:
•
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 is used in the Flash authoring environment. When
writing Flex applications, you should omit this parameter or pass a value of 0.