打印增强（Print Enhancements）是 SpreadJS V12.2 新版本的增强功能之一，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 V12.2 打印增强的更新内容，要体验这些功能并开始学习SpreadJS，请访问 SpreadJS 产品官网！

SpreadJS 纯前端表格控件 V12.2 新特性一览