| 包 | flash.printing |
| 类 | public class PrintJobOptions |
| 继承 | PrintJobOptions Object |
| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0, Flash Player 9 |
PrintJob.addPage() 方法的 options 参数配合使用。有关 addPage() 的详细信息,请参见 PrintJob 类。
相关 API 元素
| 属性 | 由以下参数定义 | ||
|---|---|---|---|
![]() | constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | |
| pixelsPerInch : Number = NaN
指定位图使用的分辨率,以每英寸像素为单位。 | PrintJobOptions | ||
| printAsBitmap : Boolean = false
指定打印作业中的内容是将作为位图打印还是将作为矢量打印。 | PrintJobOptions | ||
| printMethod : String
指定 Flash 运行时选择最合适的打印方法,或创作者希望明确选择矢量或位图打印。 | PrintJobOptions | ||
| 方法 | 由以下参数定义 | ||
|---|---|---|---|
PrintJobOptions(printAsBitmap:Boolean = false)
创建一个新的 PrintJobOptions 对象。 | PrintJobOptions | ||
![]() |
表示对象是否已经定义了指定的属性。 | Object | |
![]() |
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | |
![]() |
表示指定的属性是否存在、是否可枚举。 | Object | |
![]() |
设置循环操作动态属性的可用性。 | Object | |
![]() |
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | |
![]() |
返回指定对象的字符串表示形式。 | Object | |
![]() |
返回指定对象的原始值。 | Object | |
pixelsPerInch | 属性 |
public var pixelsPerInch:Number = NaN| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 2 |
指定位图使用的分辨率,以每英寸像素为单位。默认值是 Number.NaN,表明使用本机打印机分辨率。
此分辨率设置适用于位图和矢量打印。对于位图打印,分辨率控制如何将整张页面栅格化。对于矢量打印,分辨率控制如何将特定内容(如位图和渐变)栅格化。
printAsBitmap | 属性 |
public var printAsBitmap:Boolean = false| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0, Flash Player 9 |
指定打印作业中的内容是将作为位图打印还是将作为矢量打印。默认值是 false,代表矢量打印。
如果要打印的内容包括位图图像,则请将 printAsBitmap 设置为 true,以包括任何 Alpha 透明度和色彩效果。如果内容不包括位图图像,则使用较高品质的矢量格式(默认选项)打印内容。
例如,要将内容作为位图打印,请使用以下语法:
var options:PrintJobOptions = new PrintJobOptions();
options.printAsBitmap = true;
myPrintJob.addPage(mySprite, null, options);
注意:Adobe AIR 在 Mac OS 中不支持矢量打印。
相关 API 元素
示例 ( 如何使用本示例 )
- 构造函数使用
Loader和URLRequest对象加载该图片 (image.jpg)。它还会检查在加载过程中是否发生了错误。此处,假定该文件位于与 SWF 文件相同的目录中。需要编译 SWF 文件,并将“本地播放安全性”设置为“只访问本地文件”。 - 在加载图片后(event 为 complete),将调用
completeHandler()方法。 completeHandler()方法创建一个BitmapData对象,并在其中加载该图片(位图)。将在Sprite对象中绘制一个矩形 (frame),并使用beginBitmapFill()方法在矩形中填充该图片(BitmapData对象)。还使用了Matrix对象缩放图像以适应该矩形。(请注意,这会使图像发生扭曲。本示例中使用此对象是为了确保图像与矩形相适应。) 在填充图像后,将调用printPage()方法。printPage()方法创建一个新的打印作业实例,启动打印过程(将为用户调用打印对话框)并填充打印作业属性。addPage()方法包含有关打印作业的详细信息。此处,将包含图片(Sprite 对象)的帧设置为作为位图打印,而不是作为矢量图形打印。options是PrintJobOptions类的实例,并将其属性printAsBitmap设置为true,以便作为位图打印(默认设置为 false)。
注意:仅为本示例定义了非常有限的错误处理代码。
package {
import flash.display.Sprite;
import flash.display.Loader;
import flash.display.Bitmap;
import flash.display.BitmapData;
import flash.printing.PrintJob;
import flash.printing.PrintJobOptions;
import flash.events.Event;
import flash.events.IOErrorEvent;
import flash.net.URLRequest;
import flash.geom.Matrix;
public class printAsBitmapExample extends Sprite {
private var frame:Sprite = new Sprite();
private var url:String = "image.jpg";
private var loader:Loader = new Loader();
public function printAsBitmapExample() {
var request:URLRequest = new URLRequest(url);
loader.load(request);
loader.contentLoaderInfo.addEventListener(Event.COMPLETE, completeHandler);
loader.contentLoaderInfo.addEventListener(IOErrorEvent.IO_ERROR, ioErrorHandler);
}
private function completeHandler(event:Event):void {
var picture:Bitmap = Bitmap(loader.content);
var bitmap:BitmapData = picture.bitmapData;
var matrix:Matrix = new Matrix();
matrix.scale((200 / bitmap.width), (200 / bitmap.height));
frame.graphics.lineStyle(10);
frame.graphics.beginBitmapFill(bitmap, matrix, true);
frame.graphics.drawRect(0, 0, 200, 200);
frame.graphics.endFill();
addChild(frame);
printPage();
}
private function ioErrorHandler(event:IOErrorEvent):void {
trace("Unable to load the image: " + url);
}
private function printPage ():void {
var myPrintJob:PrintJob = new PrintJob();
var options:PrintJobOptions = new PrintJobOptions();
options.printAsBitmap = true;
myPrintJob.start();
try {
myPrintJob.addPage(frame, null, options);
}
catch(e:Error) {
trace ("Had problem adding the page to print job: " + e);
}
try {
myPrintJob.send();
}
catch (e:Error) {
trace ("Had problem printing: " + e);
}
}
}
}
printMethod | 属性 |
printMethod:String| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 2 |
指定 Flash 运行时选择最合适的打印方法,或创作者希望明确选择矢量或位图打印。
将此属性设置为在 PrintMethod 类中定义的下列值之一:
PrintMethod.AUTO:指定根据要打印的内容,自动选择矢量或位图打印。只要内容可由该方法忠实地复制,即使用矢量打印。如果存在透明效果或某些其他效果,将使用位图打印。PrintMethod.VECTOR:指定矢量打印。此设置与将printAsBitmap设置为false等效。PrintMethod.BITMAP:指定位图打印。与将printAsBitmap设置为true等效。
如果将 printMethod 设置为这些支持的值之一,则将忽略 printAsBitmap。
默认值是 null;使用 printAsBitmap 属性。
实现
public function get printMethod():String public function set printMethod(value:String):void引发
ArgumentError — 指定的 printMethod 不是在 PrintMethod 类中定义的值之一。
|
相关 API 元素
PrintJobOptions | () | 构造函数 |
public function PrintJobOptions(printAsBitmap:Boolean = false)| 语言版本: | ActionScript 3.0 |
| 运行时版本: | AIR 1.0, Flash Player 9 |
创建一个新的 PrintJobOptions 对象。将此对象传递给 PrintJob.addPage() 方法的 options 参数。
printAsBitmap:Boolean (default = false) — 如果为 true,则此对象作为位图打印。如果为 false,则此对象作为矢量图打印。
如果要打印的内容包括位图图像,则请将 注意:Adobe AIR 在 Mac OS 中不支持矢量打印。 |
相关 API 元素
Tue Jun 12 2018, 11:04 AM Z
隐藏继承的公共属性
显示继承的公共属性