包 | 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