服务端表格组件GcExcel V6.0 Update2 发布，新增支持SpreadJS的.sjs文件格式

近日，GrapeCity Documents 正式迎来其 V6.0 Update2 的发布更新，对 SpreadJS 中的 .sjs 类型文件的支持。这一重大更新将为用户带来许多令人振奋的好处。

.sjs文件有两个关键优势：空间更小以及导入导出速度更快。通过采用 .sjs格式，GcExcel实现了更高效的文件压缩，从而使文件大小大幅减小。这不仅节省了存储空间，还方便了文件的传输和共享。此外，GcExcel还针对 .sjs文件进行了优化，使其在导入和导出过程中的速度得到显著提升。

下面我们将详细介绍 GrapeCity Documents V6.0 Update2 的新特性内容，在此之前，如果您已经在使用我们的GrapeCity Documents产品，想进一步了解新功能，请移步前往葡萄城官网下载最新版产品安装包，以便同步体验。

以下是本次发布的新特性内容：

服务端表格组件 GrapeCity Documents for Excel 更新说明

支持SpreadJS的.sjs文件格式

在 GcExcel 的 V6.0 Update 2 版本中，增加了对 SpreadJS .sjs 文件格式的支持。通过导出为 .sjs 格式，可以实现更短的导出时间和更小的文件尺寸。现在，您可以将 xlsx、xlsm、csv、ssjson 等格式的文件导出为 .sjs 格式，以更高效地处理数据。

增强了Workbook类上的open和save方法，支持.sjs文件，当加载或保存.sjs文件时，可以通过OpenFileFormat和SaveFileFormat，来选择Sjs枚举项。

因为对.sjs文件格式的支持，则可以满足以下功能：

• 快速将Excel文件转换为.sjs格式
• 以更小的占用空间保存文件
• 从.sjs文件中压缩的JSON文件生成单个JSON字符串
• 使各种可用选项自定义SpreadJS.sjs文件的打开和保存

新添加两个类，SjsOpenOptions和SjsSaveOptions。在导入/导出.sjs文件时，可以通过这两个类来定制包含/排除特定的功能。

以下代码加载 SpreadJS 的 .sjs 文件，并通过使用 SjsOpenOptions 排除公式和样式，然后使用 GcExcel 打开并保存该文件。

// 创建一个新的工作簿
Workbook workbook = new Workbook();
InputStream stream = this.getResourceStream("sjs\\LoanDetails.sjs");
// .sjs 文件格式的 OpenOptions
SjsOpenOptions openOptions = new SjsOpenOptions();
openOptions.setIncludeFormulas(false);
openOptions.setIncludeStyles(false);
// GcExcel 支持使用 OpenOptions 打开 .sjs 文件格式
workbook.open(stream, openOptions);
// 保存为 .sjs 文件
workbook.save("OpenSjsWithOpenOptions.sjs");

形状文本的对齐选项

GcExcel在ITextRange接口中添加了新的TextAlignment属性，用于获取或设置形状中文本范围或段落的对齐方式。该属性可以给文本设置对齐方式，如左对齐、右对齐、居中、分散和两端对齐。在需要按照UI设计规则或按照数据格式对齐文本（例如将文本左对齐或将数字右对齐）的场景中非常有帮助。

以下代码将形状中多个段落的对齐方式设置为居中和左对齐：

IShape shape = worksheet.Shapes.AddShape(AutoShapeType.RoundedRectangle, (double)10, (double)10, (double)320, (double)150);
shape.TextFrame.TextRange.TextAlignment = TextAlignmentAnchor.Left;
shape.TextFrame.TextRange.Font.Name = "Calibri";
shape.TextFrame.TextRange.Font.Size = 16;
shape.TextFrame.TextRange.Font.Color.RGB = Color.Black;
shape.TextFrame.TextRange.Font.Underline = TextUnderlineType.None;
shape.TextFrame.TextRange.Paragraphs.Add("Quarterly Results");
shape.TextFrame.TextRange.Paragraphs[0].TextAlignment = TextAlignmentAnchor.Center;
shape.TextFrame.TextRange.Paragraphs[0].Font.Size = 28;
shape.TextFrame.TextRange.Paragraphs[0].Font.Underline = TextUnderlineType.Single;
shape.TextFrame.TextRange.Paragraphs.Add("");
shape.TextFrame.TextRange.Paragraphs.Add("Business Domain: E-Commerce");
shape.TextFrame.TextRange.Paragraphs[2].TextAlignment = TextAlignmentAnchor.Left;
shape.TextFrame.TextRange.Paragraphs.Add("Quarter: Q4");
shape.TextFrame.TextRange.Paragraphs[3].TextAlignment = TextAlignmentAnchor.Left;

在形状和图表中设置垂直文本方向

在某些文档中，希望将文本方向设置为垂直方向。GcExcel在形状和图表的API中添加了Direction属性：

• IShape.TextFrame.Direction：用于形状的文本方向
• ITickLabels.Direction：用于图表轴上刻度标签的文本方向
• IChartTitle.Direction 或 IChartTitle.TextFrame.Direction：用于图表标题的文本方向
• IAxisTitle.Direction 或 IAxisTitle.TextFrame.Direction：用于坐标轴标题的文本方向
• IDataLabels.Direction：用于指定系列数据标签的文本方向
• IDataLabel.Direction 或 IDataLabel.TextFrame.Direction：用于图表数据点上数据标签的文本方向

Direction属性接受TextDirection枚举选项，可设置文本在以下方向上的方向：

• TextDirection.Horizontal：表示文本水平显示
• TextDirection.Vertical：表示文本垂直显示
• TextDirection.Rotate90：表示文本将旋转90度
• TextDirection.Rotate270：表示文本将旋转270度
• TextDirection.Stacked：表示文本将堆叠显示，读取顺序从左到右
• TextDirection.StackedRtl：表示文本将堆叠显示，读取顺序从右到左

以下代码将文本的TextDirection设置为Stacked方向：

var shape = worksheet.Shapes.AddShape(AutoShapeType.Rectangle, worksheet.Range["C2:F12"]);
shape.TextFrame.TextRange.Add("欢迎来到葡萄城");
//将文本方向设置为堆叠，并且文本的阅读顺序从左到右。
shape.TextFrame.Direction = TextDirection.Stacked;

支持双面打印 仅适用于.NET版本

有时候我们需要在一页的两面打印一个包含长工作表的工作簿。GcExcel .NET提供了PrintOutOptions类中的Duplex枚举来启用/禁用页面上的双面打印。该枚举有四个选项，用户可以根据需要选择打印工作簿的方式：

• Duplex.Default 表示打印机的默认双面打印设置
• Duplex.Simplex 表示单面打印
• Duplex.Vertical 表示双面垂直打印
• Duplex.Horizontal 表示双面水平打印

以下代码将以双面垂直打印方式打印三份工作簿副本：

// 创建打印选项。
PrintOutOptions options = new PrintOutOptions();
// 设置打印的打印机名称为 "Printer"。
options.ActivePrinter = "Printer";
// 打印3份副本。
options.Copies = 3;
// 设置双面垂直打印。
options.Duplex = System.Drawing.Printing.Duplex.Vertical;
// 使用 "Printer" 打印此工作簿。
workbook.PrintOut(options);

服务端 PDF 组件 GrapeCity Documents for PDF 更新说明

对PDF打开和保存时的增强

在新的V6.0 Update 2版本中，GcPdf在处理由其他软件生成的现有PDF文档方面进行了改进，并提供了以下优势：

1、GcPdf现在可以加载和保存可能不严格符合PDF规范的PDF文档

2、GcPdf将保留嵌入在PDF文档中的任何非PDF规范的自定义数据

3、加载PDF文档的平均速度得到了改善

这些改进使得GcPdf能够更好地处理各种PDF文档，即使这些文档不是完全符合PDF规范或包含一些非标准的数据。同时，加载PDF文档的速度也得到了提升。

在密码未知的情况下处理受密码保护的文件

GcPdf现在允许在不指定密码的情况下处理受密码保护的文件。在加载受密码保护的文件后，您现在可以执行以下操作而无需指定密码：

读取/写入不基于PDF字符串对象的属性，例如：

• 您可以获取/设置CheckBoxField或RadioButtonField的值
• 获取某个文档的特定统计信息，例如获取页面数、注释数等
• 获取或更改文档元数据，因为元数据通常未加密
• 更改某些类型字段的值：CheckBoxField、RadioButtonField；可以更改TextBoxField、CombTextField的值，但有一些限制

如果可以在不使用PDF字符串的情况下定义新对象，您可以添加新对象。例如，您可以向一个页面或所有页面添加一个SquareAnnotation。

新增了DecryptionOptions类来表示解密选项。当加载加密的PDF时，您可以将其作为（可选）参数传递给GcPdfDocument.Load()方法。通过将DecryptionOptions.ThrowExceptionIfInvalidPassword设置为false（默认为true），以允许加载受密码保护的PDF而无需指定其密码。另一个相关的标志是DecryptionOptions.ThrowExceptionIfUnsupportedSecurityOptions，默认情况下也为true。将其设置为false可以允许GcPdf加载具有未知或损坏的安全处理程序的文档。

以下代码示例展示了如何向受密码保护的PDF添加注释，而无需指定密码：

using var fs = File.OpenRead("financial-report.pdf");
var doc = new GcPdfDocument();
doc.Load(fs, new DecryptionOptions() { ThrowExceptionIfInvalidPassword = false, ThrowExceptionIfUnsupportedSecurityOptions = false });
// 获取第一页的尺寸：
var page = doc.Pages[0];
var pageSize = page.Size;
// 添加一个方形注释：
SquareAnnotation sa = new SquareAnnotation();
sa.Page = page;
sa.Rect = new RectangleF(10, 10, pageSize.Width 20, pageSize.Height 20);
sa.Color = Color.Red;
doc.Save("AnnotationAdded.pdf");

服务端 PDF 组件 GrapeCity Documents for Word 更新说明

对于Office Math函数和转换为MathML的支持

GcWord现在支持在Word文档中创建和编辑Office Math内容。GcWord中的OMath支持包括完整的API，用于处理在科学、数学和通用目的的Word文档中广泛使用的数学符号、公式和方程。以下是OMath支持引入的新API的主要亮点：

• 用于表示GcWord中的Office Math内容的两个主要类是OMathParagraph和OMath。OMathParagraph表示带有Office Math内容的段落，而OMath表示内联的Office Math区域，可以包含在OMathParagraph或常规段落中
• 提供了专门的类（如OMathFunction、OMathEquationArray、OMathRadical等），用于表示OMath区域中的各种数学结构。这些类都是从通用的抽象OMathStruct基类派生而来
• 可以通过新的RangeBase属性（OMathParagraphs、OMaths、OMathStructs、OMathElements和OMathMatrixRows）访问Office Math内容
• 为了方便添加MS Word支持的内置方程，RangeBase、OMathParagraph、OMath和OMathElement类上提供了方便的Add/Insert方法，接受一个OMathBuiltInEquation枚举值，用于识别所需的方程
• 包含一个实用的MathMLConverter类，可以方便地在GcWord的OMath内容和MathML之间进行转换

以下代码使用OMath类和其函数将一个方程添加到Word文件中：

var sampleDoc = new GcWordDocument();
var om = sampleDoc.Body.AddParagraph().AddOMathParagraph().AddOMath();
om.AddRun("Γ").Font.Italic = false;
om.AddDelimiter(new string[] { "z" });
om.AddRun("=");
var nary = om.AddNary("", "0", "∞", "∫");
nary.Base.AddSuperscript("t", "z-1");
nary.Base.AddSuperscript("e", "-t");
nary.Base.AddRun("dt");
om.AddRun("=");
var frac = om.AddFraction();
var superscript = frac.Numerator.AddSuperscript("e", "-");
superscript.Superscript.AddRun("γ").Font.Bidi = true;
superscript.Superscript.AddRun("z");
frac.Denominator.AddRun("z");
nary = om.AddNary("", "k=1", "∞", "∏");
superscript = nary.Base.AddSuperscript("", "-1");
var delimiter = superscript.Base.AddDelimiter();
var item = delimiter.Items.Add();
item.AddRun("1+");
item.AddFraction("z", "k", null);
superscript = nary.Base.AddSuperscript("e", "z");
superscript.Superscript.AddRun("/").OMathFormat.IsLiteral = true;
superscript.Superscript.AddRun("k");
om.AddRun(",  γ≈0.577216");
sampleDoc.Save("MathEquation.docx");