flash.printing.PrintJobOptions (Flex 3.2)

	属性	定义方
		constructor : Object 对类对象或给定对象实例的构造函数的引用。	Object
		printAsBitmap : Boolean = false 指定打印作业中的内容是将作为位图打印还是将作为矢量打印。	PrintJobOptions
		prototype : Object [静态] 对类或函数对象的原型对象的引用。	Object

	方法	定义方
		PrintJobOptions(printAsBitmap:Boolean = false) 创建一个新的 PrintJobOptions 对象。	PrintJobOptions
		hasOwnProperty(name:String):Boolean 指示对象是否已经定义了指定的属性。	Object
		isPrototypeOf(theClass:Object):Boolean 指示 Object 类的实例是否在指定为参数的对象的原型链中。	Object
		propertyIsEnumerable(name:String):Boolean 指示指定的属性是否存在、是否可枚举。	Object
		setPropertyIsEnumerable(name:String, isEnum:Boolean = true):void 设置循环操作动态属性的可用性。	Object
		toString():String 返回指定对象的字符串表示形式。	Object
		valueOf():Object 返回指定对象的原始值。	Object

属性详细信息

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 中不支持矢量打印。

示例

下面的示例先加载一幅图片并放在矩形帧中，然后将该图片作为位图进行打印。

构造函数使用 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);    
            }
        }
    }
}

构造函数详细信息

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，则此对象作为矢量图打印。

如果要打印的内容包括位图图像，则请将 printAsBitmap 属性设置为 true，以包括任何 Alpha 透明度和色彩效果。如果内容不包含位图图像，则请省略此参数，以便以较高品质的矢量格式（默认选项）打印内容。

注意：Adobe AIR 在 Mac OS 中不支持矢量打印。

另请参见

PrintJob.addPage()

Adobe® Flex™ 3.2 语言参考		全部包 \| 全部类 \| 语言元素 \| 索引 \| 附录 \| 约定 \| 框架无框架
PrintJobOptions	属性 \| 方法 \| 事件 \| 样式 \| 效果 \| 常量 \| 示例

包	flash.printing
类	public class PrintJobOptions
继承	PrintJobOptions Object