全局设置

概述

GcExcel 模板中的全局设置是在定义时应用于整个模板的设置。当需要在多个字段上应用相同的属性时，这些设置可以节省大量工作。全局设置可以应用于所有模板布局，甚至可以应用于工作簿的多个工作表。

GcExcel 模板提供的全局设置说明如下：

KeepLineSize
InsertMode
DebugMode
PaginationMode
EmbedFontForFormFields

如何配置

全局设置使用的是 Excel 中的公式名称，在模板填充之前，配置好全局设置，即可使其生效。

全局设置的 Name(名称)，需要添加 'TemplateOptions.' 作为前缀，因此完整的名字为：

TemplateOptions.KeepLineSize
TemplateOptions.InsertMode
TemplateOptions.DebugMode
TemplateOptions.PaginationMode
TemplateOptions.EmbedFontForFormFields

在 SpreadJS 或者 Excel 中定义全局设置

全局设置可以在“名称管理器”对话框中的Excel模板布局中定义，如下所示。通过“公式”->“定义的名称”，然后单击“名称管理器”，可以访问“名称管理器”。

SpreadJS:

Excel:

使用 GcExcel API 设置全局设置

除了直接在模板中内置公式名称外，也可以通过使用内置工作簿定义的名称 TemplateOptions. 加载Excel模板后，可以在 GcExcel 中定义全局设置。INames 接口的 Add 方法可用于应用全局设置。该方法将 Name 和 RefersTo 属性作为参数（请注意，他们是区分大小写的）：

内置定义名称中 Name 属性的值作为模板全局选项的名称。
内置定义名称中 RefersTo 属性的值作为模板全局选项的值。

请参阅以下示例代码以指定模板中的全局设置：

Workbook workbook = new Workbook();
workbook.open("template.xlsx");
 
//Init template global settings
workbook.getNames().add("TemplateOptions.KeepLineSize", "true");
workbook.getNames().add("TemplateOptions.InsertMode", "EntireRowColumn");
//Global setting for PDF form fields
workbook.getNames().add("TemplateOptions.EmbedFontForFormFields", "true");

//Init DebugMode setting
workbook.getNames().add("TemplateOptions.DebugMode", "true");
//Init template global settings 
workbook.getNames().add("TemplateOptions.PaginationMode", "true");
//Add data source
workbook.addDataSource("ds", ds);
 
//Invoke to process the template
workbook.processTemplate();
 
workbook.save("report.xlsx");