ACTIONSCRIPT 3 Developer’s Guide en

ACTIONSCRIPT 3.0 DEVELOPER’S GUIDE
Printing
Printing for landscape or portrait orientation
Flash Player 9 and later, Adobe AIR 1.0 and later
Because Flash Player and AIR can detect the settings for orientation, you can build logic into your ActionScript to
adjust the content size or rotation in response to the printer settings, as the following example illustrates:
if (myPrintJob.orientation == PrintJobOrientation.LANDSCAPE)
{
mySprite.rotation = 90;
}
Note: If you plan to read the system setting for content orientation on the paper, remember to import the
PrintJobOrientation class. The PrintJobOrientation class provides constant values that define the content orientation on
the page. You import the class using the following statement:
import flash.printing.PrintJobOrientation;
Responding to page height and width
Flash Player 9 and later, Adobe AIR 1.0 and later
Using a strategy that is similar to handling printer orientation settings, you can read the page height and width settings
and respond to them by embedding some logic into an if statement. The following code shows an example:
if (mySprite.height > myPrintJob.pageHeight)
{
mySprite.scaleY = .75;
}
In addition, a page’s margin settings can be determined by comparing the page and paper dimensions, as the following
example illustrates:
margin_height = (myPrintJob.paperHeight - myPrintJob.pageHeight) / 2;
margin_width = (myPrintJob.paperWidth - myPrintJob.pageWidth) / 2;
Advanced printing techniques
Adobe AIR 2 and later
Starting with Adobe AIR 2, the PrintJob class has additional properties and methods, and three additional classes are
supported: PrintUIOptions, PaperSize, and PrintMethod. These changes allow additional printer workflows and give
authors greater control over the printing process. Changes include:
Page setup dialogs: Both standard and custom page setup dialogs can be displayed. The user can set page ranges,
paper size, orientation, and scaling before printing.
Print view: A viewing mode can be created which accurately shows paper size, margins, and the position of content
on the page.
Restricted printing: Authors can restrict printing options, such as the range of printable pages.
Quality options: Authors can adjust the print quality for a document and allow the user to select resolution and
color options.
Last updated 6/6/2012
928