打印增强（Print Enhancements）是 SpreadJS 新版本的增强功能之一，SpreadJS 的打印功能除了允许用户同时打印工作簿和工作表外，还包括了如下新增内容：

• 新事件 BeforePrint
• 显示打印预览线
• 打印页面对象
• 增加打印背景水印

新事件 BeforePrint

在新版本的 SpreadJS 中，我们增加了一个新事件：BeforePrint。通过此事件，开发人员可以在启动打印程序时取消打印。同时，此事件还允许用户访问打印内容的iframe，这将使开发人员能够将打印的详细信息发送到其他类似的flash中。

要利用该事件，只需将spread实例绑定到BeforePrint事件即可：

spread.bind(GC.Spread.Sheets.Events.BeforePrint, function (e, data) {
 var iframe = data.iframe;
 data.cancel = true;
});

显示打印预览线

与Excel一样，SpreadJS支持视窗（Viewport）区域中的打印预览线指示，如下图蓝色框标识，虚线显示的是将要打印的页面范围：

用户可以使用“isPrintLineVisible”接口轻松设置打印预览线：

var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"));
var sheet = spread.getActiveSheet();
//Show print line
sheet.isPrintLineVisible(true);
//Hide print line
sheet.isPrintLineVisible(false);

除此之外，还可以通过设置columnStart、rowStart、columnEnd和rowEnd等属性，绘制一个矩形框，用以显示要打印的区域。

如图，打印预览线也将显示在此矩形中：

PageInfo 打印页面对象

通过调用 PageInfo 接口，用户可了解每一个将被打印的页面范围，PageInfo 返回的对象结构如下：

{
 pages:pageItem[],
}
pageItem:{
 row:number,
 column:number,
 rowCount:number,
 columnCount:number
}

要获取此对象，只需调用“pageInfo”函数：

spread.pageInfo(sheetIndex);

增加打印背景水印

在打印电子表格时，部分业务场景可能需要在页面上同时打印公司水印。通过 SpreadJS V12.2 的打印增强功能，只需几行代码，就能完成此操作：

var printInfo = activeSheet.printInfo();
var watermark1 = {x:0, y:0, width:100, height:100, imageSrc:".image/watermart1.jpg", page:"0,1,2,3,5,10"};
printInfo.watermark([watermark1]);

当然，针对不同的页面也可以有不同的水印效果，只需在“水印”功能中提供一系列水印样式即可：

var printInfo = activeSheet.printInfo();
var watermark1 = {x:0, y:0, width:100, height:100, imageSrc:".image/watermart1.jpg", page:"all"};
var watermark2 = {x:400, y:400, width:30, height:30, imageSrc:".image/watermart2.jpg", page:"all"};
printInfo.watermark([watermark1, watermark2]);

以上就是 SpreadJS 打印增强的更新内容，要体验这些功能并开始学习SpreadJS，请点击文末了解更多访问 SpreadJS 产品官网！

关于 SpreadJS 纯前端表格控件

SpreadJS 是一款基于 HTML5 的纯前端电子表格控件，以“高速低耗、高度类似Excel、可无限扩展”为产品特色，提供移动跨平台和浏览器支持，同时满足 .NET、Java、App 等应用程序中的 Web Excel 组件开发、数据填报、在线文档、图表公式联动、类 Excel UI 设计等业务场景，为您带来亲切的 Excel 体验。SpreadJS 在数据可视化、Excel 导入导出、公式引用、数据绑定、框架集成等场景下无需大量代码开发和测试，极大降低了企业研发成本和项目交付风险。