【新版本】"GrapeCity Documents V7.0 导出功能全面升级，助力数据处理效率提升

近日，GrapeCity Documents 正式迎来其V7.0 的发布更新，导出功能全面增强，提供更优质的导出体验，帮助用户更高效地处理数据。

本次更新的增强功能为用户提供了更便捷、高效的模板生成、HTML 导出、CSV 导出及图表导出功能，同时加强了与 SpreadJS 前端表格控件的兼容性，为用户带来更加流畅、无缝的使用体验，帮助用户更快速地处理和展示数据，提升工作效率并减少操作复杂度。

下面将详细介绍 GrapeCity Documents V7.0 中的新特性。在此之前，如果您已经在使用了GrapeCity Documents产品，希望进一步了解新功能，可前往葡萄城官网下载最新版产品安装包，以便进行同步体验。

重要信息：GrapeCity Documents 组件包更名为 GcDocs

为了更好的持续改进产品以及服务中国用户，从 V7.0 开始 GrapeCity Documents 正式更名为 GcDocs，这个更名会延伸至 GcDocs 套件下的所有 API 组件。

需要强调的是 ，GcDocs 仅仅是包名字的修改，组件内所有的命名空间，类型名等并未更名，对于您已有的代码，无需做任何修改。

下面让我们开始了解 V7 的新功能。

服务端表格组件 GcDocs.Excel 更新说明

1.增加异步自定义函数

当遇到需要从外部应用获取数据或执行耗时的计算时，传统的同步函数会阻止Excel的响应，直到计算完成，从而导致用户界面的延迟。在GrapeCity Documents V7.0 中Excel支持使用异步编程技术的自定义函数进行异步计算。使用异步计算，您可以通过在耗时的任务进行时允许其他操作继续来提高响应性。

2.GcExcel 模板增强

保持图片比例

很多场景都需要保持图片的比例，例如（国旗，照片等）。为了防止比例因单元格的大小而改变，使得它们看起来失真。在 GrapeCity Documents V7 版本中，GcExcel 模板中引入了新的属性，即 image.keepaspect 或 image.ka。当设置为 true 时，可确保图像的比例，从而允许其适合单元格大小，而不管其高度或宽度如何。

示例：以下代码将国旗的比例设置为 True，来让国旗以正常比例显示

{{ds.BikeSeries.CountryImage(image=true,image.keepaspect=true)}}

支持在分页模式下重复形状和图片

GcExcel 模板能够支持分页模式，可对报表中的工作表进行分页。该功能在每个工作表都具有一致布局但数据不同的场景中特别有用，比如发票、进展报告和医学检测报告等。

在这些报表中，通常需要重复使用形状和图像，例如标志或图形以及数据。在新版本中，该增强功能可以在处理 Excel 模板时重复使用带有数据的形状和图像。这个增强功能能够确保更动态地处理形状和图像，为报表生成过程增加了灵活性。

3.导出 Html 支持 Inline CSS

GcExcel 支持将 Excel 电子表格导出为 HTML，并且提供了包含单独的 CSS 文件作为一个整体的灵活性。值得注意的是，在将内容导出 HTML 通过电子邮件共享时，或集成到内容管理系统(CMS)中的情况下，CSS 样式需要内嵌至 HTML 标签内。

在最新的更新中，GcExcel 引入了一项新功能，可以在导出 HTML 时，将 CSS 样式存储在标签内（内联样式）。与此功能相配套，GcExcel 引入了HtmlSaveOptions.CssExportType 枚举，提供三个值来将 Excel 文件以不同的 CSS 选项导出为 HTML：

External：将 CSS 导出到单独的文件中

Internal：将 CSS 与 style 标签一起导出到 HTML 中

Inline：将 CSS 与 HTML 元素内的 style 属性一起导出

示例：以下代码将 Excel 工作簿导出为具有 CssExportType.Inline 选项的 HTML。请注意，样式标签嵌入在 HTML 文件中。

4.页面设置起始页码支持“自动”

在打印 Excel 表时，用户可以在页面设置对话框中使用'FirstPageNumber'属性来给页面加上页码。如果要使用默认的页码系统，可以将该属性设置为'Auto'。

为解决编程场景中的需要，GcExcel 引入IPageSetup.IsAutoFirstPageNumber 属性，便于在打印时检索和修改第一页的页码是否设置为'Auto'。默认值为 true；但是，如果 IPageSetup.FirstPageNumber 属性已经明确设置，那么 IPageSetup.IsAutoFirstPageNumber 属性将变为 false，并需要重新设置。

5.增强趋势图的格式设置

在图表中绘制数据时，直观地表示潜在趋势至关重要。Excel 中的趋势线是分析数据和根据现有趋势预测未来值的宝贵工具。GcExcel 一直支持使用 ITrendline 接口向图表添加趋势线方程，特别是通过 ITrendline.DisplayEquation 和 ITrendline.DisplayRSquared 属性。

新版本中，GcExcel 向 ITrendline 接口引入了格式化属性，以增强趋势线的视觉效果。ITrendline 接口中添加了一个新属性 DataLabel，允许用户访问与趋势线关联的数据标签。此功能使用户能够利用 IDataLabel 接口中的字体、格式、数字格式、角度、方向和自动图文集等属性来格式化趋势线方程标签。

此外，新版本还提供 ITrendline.Delete 方法，可以删除趋势线方程标签。值得注意的是，趋势线方程现在支持导出为 PDF、HTML 和图像，从而确保各种格式之间的一致性。该增强功能有助于在 GcExcel 中以更全面、更具视觉吸引力的方式表示趋势线数据。

示例：在下面的快照中，使用 IDataLabel 接口的新属性格式化趋势线方程。

6.PDF 导出支持平滑线图表

为了追求视觉效果和对图表数据的全面理解，GcExcel 支持平滑的图表线，同时也支持导出 PDF。

以下图表类型受益于此功能：

• 折线图

• 散点图

• 组合图

7.PDF 导出支持漏斗图

在新版本中，GcExcel还将支持漏斗图将 Excel 文件导出为 PDF。因此，您现在可以将漏斗图添加到 Excel 并直接将文件保存为 PDF。

8.增强与 SpreadJS 兼容

GcExcel 新增对 SpreadJS 功能的支持，增强与客户端 SpreadJS 产品的兼容性。需注意的是，这些附加功能仅适用于 SpreadJS，并且与 Microsoft Excel 不兼容。

• 对 cell.altText 属性的支持

• 对 IRange.DefaultValue 的支持

• 支持遮罩样式

• 支持受保护工作表中的密码

除此之外，GcExcel 新版本还支持改善选项按钮的分组策略、支持在 PDF 中生成交互式表单、CSV 导出支持指定列包含“引号”、新增单元格默认值等功能。

服务端PDF组件GcDocs.PDF 更新说明

1.自定义时间戳

在某些场景中，由于安全原因，服务可能无法连接并从客户端返回所需的时间戳。在此情况下，可能需要一个定制的时间戳服务向客户端发送一个有效的时间戳令牌。然后客户端利用时间戳令牌对 PDF 文件进行签名，以确保符合各种 PAdES B-T/B-LT/B-LTA 等级的要求。

简而言之，要求是在使用 PDF API 对 PDF 文档进行签名时定制时间戳令牌的生成。现在您可以在 GcPdfV7 中通过使用新的 ITimeStampGenerator 接口实现相同的功能，该接口使用户能够通过将其分配给 SignatureProperties 和 TimeStampProperties 类的 TimeStamp 属性来轻松生成个性化的时间戳令牌。

2.新的插入符注释

新版本中，支持在 GcPDF 中引入了插入符注释，这是一种用于审阅 PDF 文档的强大工具。CaretAnnotation 类使得以编程方式精确指出缺失的内容或必要的更改成为可能。如果你需要以编程方式在文档的多个位置添加插入符注释，那么该功能将特别有用。

服务端Word组件 GcDocs.Word 更新说明

图片效果

在不断发展的文档创建领域中，动态和视觉吸引力的内容需求至关重要。为满足对多功能和可定制文档元素的需求，GcWord V7 推出一套强大的功能，允许用户对图片应用各种不同的特效。这一拓展不仅增强了文档的视觉吸引力，还简化了通过代码整合 Microsoft Word 支持的图片特效的过程。使用这些特效，您可以对图片进行以下的编程操作：

• 调整图片的亮度和对比度

• 使用预设色彩重新着色

• 修改图像颜色

• 设置透明色

• 在图片上叠加特定的颜色色调

• 还有更多其他功能...

在下面的示例中，将一个图像添加到 Word 文档中，并使用 GcWord API 的 Picture.ImageData.RecolorType 枚举将其重新着色为灰度。

 

0