包 | mx.printing |
类 | public class FlexPrintJob |
继承 | FlexPrintJob Object |
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
公共属性
属性 | 由以下参数定义 | ||
---|---|---|---|
constructor : Object
对类对象或给定对象实例的构造函数的引用。 | Object | ||
pageHeight : Number [只读]
打印机页面上可打印区域的高度;不包括用户设置的任何边距。 | FlexPrintJob | ||
pageWidth : Number [只读]
打印机页面上可打印区域的宽度;不包括用户设置的任何边距。 | FlexPrintJob | ||
printAsBitmap : Boolean
指定是以位图 (true) 还是以向量格式 (false) 打印作业内容。 | FlexPrintJob |
公共方法
方法 | 由以下参数定义 | ||
---|---|---|---|
构造函数。 | FlexPrintJob | ||
将 UIComponent 对象添加到正在打印的对象列表。 | FlexPrintJob | ||
表示对象是否已经定义了指定的属性。 | Object | ||
表示 Object 类的实例是否在指定为参数的对象的原型链中。 | Object | ||
表示指定的属性是否存在、是否可枚举。 | Object | ||
将添加的对象发送到打印机以开始打印。 | FlexPrintJob | ||
设置循环操作动态属性的可用性。 | Object | ||
初始化 PrintJob 对象。 | FlexPrintJob | ||
返回此对象的字符串表示形式,其格式设置遵守区域设置特定的约定。 | Object | ||
返回指定对象的字符串表示形式。 | Object | ||
返回指定对象的原始值。 | Object |
属性详细信息
pageHeight | 属性 |
pageWidth | 属性 |
printAsBitmap | 属性 |
printAsBitmap:Boolean
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
指定是以位图 (true
) 还是以向量格式 (false
) 打印作业内容。以位图打印支持包含具有 alpha 透明度或颜色效果的位图图像的输出。如果内容不包含具有 alpha 透明度或颜色效果的任何位图图像,则您可以通过将 printAsBitmap
属性设置为 false
以较高质量向量格式打印。
默认值为 true。
实现
public function get printAsBitmap():Boolean
public function set printAsBitmap(value:Boolean):void
构造函数详细信息
FlexPrintJob | () | 构造函数 |
public function FlexPrintJob()
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
构造函数。
方法详细信息
addObject | () | 方法 |
public function addObject(obj:IUIComponent, scaleType:String = "matchWidth"):void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将 UIComponent 对象添加到正在打印的对象列表。返回 start()
方法后调用此方法。每次调用此方法都会启动新页面,因此您应该在页面大小的区块中编排对象格式。可以使用 PrintDataGrid 类来将数据网格扩展到多个页面中。
参数
obj:IUIComponent — 要打印的对象。
| |
scaleType:String (default = "matchWidth ") — 用于控制对象如何置于一个或多个打印页面上的缩放技术。必须是 FlexPrintJobScaleType 类中定义的常量值之一。
|
相关 API 元素
send | () | 方法 |
public function send():void
语言版本: | ActionScript 3.0 |
产品版本: | Flex 3 |
运行时版本: | Flash Player 9, AIR 1.1 |
将添加的对象发送到打印机以开始打印。使用 addObject()
方法添加打印页面后调用此方法。
start | () | 方法 |
示例 如何使用本示例
FormPrintHeader.mxml
<?xml version="1.0"?> <!-- Custom control for the header area of the printed page. --> <s:VGroup name="FormPrintHeader" xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" width="60%" horizontalAlign="right" > <s:Label text="This is a placeholder for first page contents"/> </s:VGroup>
FormPrintFooter.mxml
<?xml version="1.0"?> <!-- Custom control for the footer area of the printed page. --> <s:VGroup name="FormPrintFooter" xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" width="60%" horizontalAlign="right" > <!-- Declare and initialize the product total variable. --> <fx:Script> <![CDATA[ [Bindable] public var pTotal:Number = 0; ]]> </fx:Script> <s:Label text="Product Total: {pTotal}"/> </s:VGroup>
FormPrintView.mxml
<?xml version="1.0"?> <!-- Custom control to print the Halo DataGrid control on multiple pages. --> <s:VGroup name="FormPrintView" xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" xmlns="*"> <fx:Script> <![CDATA[ import mx.core.*; // Declare and initialize the variables used in the component. // The application sets the actual prodTotal value. [Bindable] public var pageNumber:Number = 1; [Bindable] public var prodTotal:Number = 0; // Control the page contents by selectively hiding the header and // footer based on the page type. public function showPage(pageType:String):void { if (pageType == "first" || pageType == "middle") { // Hide the footer. footer.includeInLayout = false; footer.visible = false; } if (pageType == "middle" || pageType == "last") { // The header won't be used again; hide it. header.includeInLayout = false; header.visible = false; } if (pageType == "last") { // Show the footer. footer.includeInLayout = true; footer.visible = true; } //Update the DataGrid layout to reflect the results. validateNow(); } ]]> </fx:Script> <!-- The template for the printed page, with the contents for all pages. --> <s:VGroup width="80%" horizontalAlign="left"> <s:Label text="Page {pageNumber}"/> </s:VGroup> <FormPrintHeader id="header" /> <!-- The data grid. The sizeToPage property is true by default, so the last page has only as many grid rows as are needed for the data. --> <mx:PrintDataGrid id="myDataGrid" width="60%" height="100%"> <!-- Specify the columns to ensure that their order is correct. --> <mx:columns> <mx:DataGridColumn dataField="Index" /> <mx:DataGridColumn dataField="Qty" /> </mx:columns> </mx:PrintDataGrid> <!-- Create a FormPrintFooter control and set its prodTotal variable. --> <FormPrintFooter id="footer" pTotal="{prodTotal}" /> </s:VGroup>
PrintDataGridExample.mxml
<?xml version="1.0"?> <!-- Main application to print a Halo DataGrid control on multiple pages. --> <s:Application name="PrintDataGridExample.mxml" xmlns:fx="http://ns.adobe.com/mxml/2009" xmlns:s="library://ns.adobe.com/flex/spark" xmlns:mx="library://ns.adobe.com/flex/mx" initialize="initData();"> <fx:Script> <![CDATA[ import mx.printing.*; import mx.collections.ArrayCollection; import FormPrintView; import mx.core.FlexGlobals; // Declare variables and initialize simple variables. [Bindable] public var dgProvider:ArrayCollection; public var footerHeight:Number = 20; public var prodIndex:Number; public var prodTotal:Number = 0; // Data initialization. public function initData():void { // Create the data provider for the DataGrid control. dgProvider = new ArrayCollection; } // Fill the dgProvider ArrayCollection with the specified items. public function setdgProvider(items:int):void { prodIndex=1; dgProvider.removeAll(); for (var z:int=0; z<items; z++) { var prod1:Object = {}; prod1.Qty = prodIndex * 7; prod1.Index = prodIndex++; prodTotal += prod1.Qty; dgProvider.addItem(prod1); } } // The function to print the output. public function doPrint():void { var printJob:FlexPrintJob = new FlexPrintJob(); if (printJob.start()) { // Create a FormPrintView control as a child of the current view. var thePrintView:FormPrintView = new FormPrintView(); FlexGlobals.topLevelApplication.addElement(thePrintView); //Set the print view properties. thePrintView.width=printJob.pageWidth; thePrintView.height=printJob.pageHeight; thePrintView.prodTotal = prodTotal; // Set the data provider of the FormPrintView component's data grid // to be the data provider of the displayed data grid. thePrintView.myDataGrid.dataProvider = myDataGrid.dataProvider; // Create a single-page image. thePrintView.showPage("single"); // If the print image's data grid can hold all the provider's rows, // add the page to the print job. if (!thePrintView.myDataGrid.validNextPage) { printJob.addObject(thePrintView); } // Otherwise, the job requires multiple pages. else { // Create the first page and add it to the print job. thePrintView.showPage("first"); printJob.addObject(thePrintView); thePrintView.pageNumber++; // Loop through the following code until all pages are queued. while (true) { // Move the next page of data to the top of the print grid. thePrintView.myDataGrid.nextPage(); thePrintView.showPage("last"); // If the page holds the remaining data, or if the last page // was completely filled by the last grid data, queue it for printing. // Test if there is data for another PrintDataGrid page. if (!thePrintView.myDataGrid.validNextPage) { // This is the last page; queue it and exit the print loop. printJob.addObject(thePrintView); break; } else { // This is not the last page. Queue a middle page. thePrintView.showPage("middle"); printJob.addObject(thePrintView); thePrintView.pageNumber++; } } } // All pages are queued; remove the FormPrintView control to free memory. FlexGlobals.topLevelApplication.removeElement(thePrintView); } // Send the job to the printer. printJob.send(); } ]]> </fx:Script> <s:Panel title="DataGrid Printing Example" width="75%" height="75%" horizontalCenter="0" verticalCenter="0"> <s:VGroup left="10" right="10" top="10" bottom="10"> <mx:DataGrid id="myDataGrid" dataProvider="{dgProvider}"> <mx:columns> <mx:DataGridColumn dataField="Index"/> <mx:DataGridColumn dataField="Qty"/> </mx:columns> </mx:DataGrid> <s:Label width="100%" color="blue" text="Specify the number of lines and click Fill Grid first. Then you can click Print."/> <s:TextInput id="dataItems" text="35"/> <s:HGroup> <s:Button id="setDP" label="Fill Grid" click="setdgProvider(int(dataItems.text));"/> <s:Button id="printDG" label="Print" click="doPrint();"/> </s:HGroup> </s:VGroup> </s:Panel> </s:Application>
Tue Jun 12 2018, 11:04 AM Z