导出为 PDF

GcExcel .NET 允许您将工作簿导出为PDF文件。在执行导出操作时，您还可以应用样式、自定义字体、添加安全选项、配置文档属性以及调整行高或列宽。

若要将工作簿中所有可见的电子表格保存为便携式文档文件（PDF），请使用 IWorkbook 接口的 IWorkbook.Save 方法。工作簿中的每个工作表都会保存为PDF文件中的新页面。您还可以使用 IWorksheet 接口的 IWorksheet.Save 方法仅将当前工作表（活动工作表）导出为PDF格式。

在PDF导出时对图像的处理也非常高效。如果一张图片在电子表格中多次使用，GcExcel会保留图片的单个副本，从而减小导出的PDF文件的大小。

请参考以下示例代码将电子表格导出为PDF文件：

//create workbook and add two sheets.
Workbook workbook = new Workbook();
IWorksheet sheet1 = workbook.Worksheets[0];
IWorksheet sheet2 = workbook.Worksheets.Add();

//export workbook to pdf file, the exported file has two pages.
workbook.Save(@"D:\workbook.pdf", SaveFileFormat.Pdf);

//just export a particular sheet to pdf file
sheet1.Save(@"D:\sheet1.pdf", SaveFileFormat.Pdf);

此外，GcExcel 提供 PdfSaveOptions 类来自定义PDF文件的导出。这些选项如下所示：

	类	选项	描述
导出选项	PdfSaveOptions	BorderOptions	导出PDF时存储边框选项。
		DocumentProperties	表示PDF的文档属性。
		FileFormat	表示保存工作簿的格式。
		FormFields	指示是否用PDF表单域替换Excel表单控件。并非所有控件和属性都受支持。
		ImageQuality	设置图像质量百分比。此值必须介于0（最低质量，最大压缩）和100（最高质量，无压缩）之间。默认值为75。
		OpenActionScript	设置打开保存的PDF文件时要执行的JavaScript。
		PrintBackgroundPicture	指示是否在页面上打印工作表的背景图像。
		PrintTransparentCell	指示是否在页面上打印单元格背景颜色的透明度。
		SecurityOptions	表示PDF的安全设置。
		ShrinkToFitSettings	关于对自动换行文本执行缩小以适应的设置。
		ViewerPreferences	包含指定当前文档应如何显示的信息的设置。
		IncludeAutoMergedCells	指示是否包含自动合并的单元格。默认值为 false。

GcExcel 支持通过使用 PdfSaveOptions 类的 OpenActionScript 属性在PDF文档中设置JavaScript。打开保存的PDF文档时将执行该JavaScript。

请参考以下示例代码在处理以创建PDF表单的Excel模板中设置JavaScript：

Workbook workbook = new Workbook();
workbook.Open("SampleTemplate.xlsx");

workbook.ProcessTemplate();
PdfSaveOptions options = new PdfSaveOptions();
        
//Set JavaScript
options.OpenActionScript = "var fld1 = this.getField(\"num\");" +
"fld1.value = fld1.value;" +
"this.dirty = false;";

workbook.Save("SampleTemplate.pdf", options);

在执行导出操作时，您可以配置字体、设置样式并指定页面设置选项，以便根据您的偏好自定义PDF。有关更多详细信息，请参考以下主题：

在打印PDF文档时，您还可以配置为根据PDF页面大小自动选择纸张来源。有关更多信息，请参考配置纸张来源。

限制

GcExcel不支持将图片设置（如线条格式、填充格式、亮度、对比度、水印颜色类型和emf格式的黑白图片）导出到PDF文件。
PatternType 枚举的 DiagonalCross、Horizontal、Vertical、Cross、DashedUpwardDiagonal 和 DashedDownwardDiagonal 在GcExcel中有渲染限制。