Spread .NET 表格控件 - 历史版本

按设定像素的数量实现像素级滚动

本次发布，使用 Spread .NET 可以将垂直滚动条设置为使用鼠标滚轮以特定数量的像素为增量滚动。

使用方法：VerticalScrollBarMode.PixelEnhanced API 启用此行为，使用属性 VerticalScrollBarSmallChange 的值确定要滚动的像素数量。

支持 .NET 5 和 .NET Core 3.1

Spread .NET V14.0 提供了一个用于 .NET 5 和 .NET Core 3.1 WinForms 开发环境的 NuGet 程序包。

使用这个新程序包，就可以在 .NET 5 和 .NET Core 3.1 中使用 Spread 表格控件创建 WinForms 应用程序，并使用 GrapeCity Spread .NET 控件移植现有的 WinForms 项目。

单元格类型增强，可以将 .NET 对象作为自定义单元格类型

单元格类型增强是 Spread .NET 14.0 中的一项主要更新。

借助这一更新，你可以通过自定义数据类，来创建自定义单元格类型，然后使用该类创建对象并将其设置为单元格的值。该对象将使用自定义图像显示在单元格中，并显示该对象的默认属性。

另外，当该单元格处于活动状态时，“插入数据”工具将显示在该单元格旁边（请参见上图的 B12 单元格）。单击“插入数据”工具后，将显示一个弹出列表，列出可在相邻单元格或列中插入的可用数据字段：

单击弹出列表中的字段将自动插入适当的公式，您也可以单击单元格中的标志符号，或在单元格处于活动状态时按 Ctrl + Shift + F5 来显示对象的数据卡片：

要创建这些数据类型，可以为单元格数据类型先定义类，并指定要显示的属性，然后创建这个类的对象实例，并创建 RichValue 来实现 IRichValue 对象。

当然，你也可以直接在单元格数据类型类上实现 IRichValue 并通过接口指定字段（上面示例中的 Vehicle 类就是通过这种方式实现的）。

为了加速创建单元格的自定义数据类型，Spread .NET 实现了内置的类 BuiltInRichValue，可用于将 DataView 或 DataTable 包装在单元格数据类型内，如下图所示：

超链接功能增强

Spread .NET 14.0 增强了超链接功能，包括：

• 链接到单元格引用
• 链接到命名范围
• 链接到tables
• 链接到电子邮件
• 链接到网站和文件
• 从单元格，形状和图像上来链接
• 自定义链接的提示文本
• 编辑单元格时自动创建链接

通过启用 AutoCreateHyperlink 功能，在 Spread .NET 中编辑单元格时可以自动创建超链接，包括使用特殊语法（例如“spread://Sheet1!A1”）指定工作簿内部链接的位置，该语法还支持命名范围（如“spread://SalesSummary”）和表格名（如“spread://Table1”）。

使用 Ctrl + K 调用 “编辑超链接”对话框，就可以修改链接目标，如要显示的文本和屏幕提示文本：

新增 LET 函数，优化计算效率

LET 函数允许您在公式中预定义名称，然后使用这些名称来计算表达式。

例如，一个简单的表达式“SUM(x, 1)”，其中 x 是一个命名参数，可向它赋值（在本例中，x 的赋值为 5）。
=LET(x, 5, SUM(x, 1))
将此公式输出到单元格后，它将返回值 6。

使用此函数，你不必记住特定范围或单元格引用的是什么，也不用关心一个计算做了什么，甚至不必再复制粘贴相同的表达式。

该函数通过消除多余的中间值来优化你的计算速度，中间值仅需计算一次，便可重复使用。

在上面的示例中，左侧的电子表格使用LET 函数来优化计算，其计算结果比不使用 LET 功能并执行相同计算的右侧电子表格快了三倍。

支持移动 Sharp 形状中的点来创建自定义形状

Spread .NET 的形状引擎支持导入和创建 Microsoft Excel 形状。

在新版本中，新增的“编辑点”命令使用户可以自定义形状中的点和线段。右键单击形状，可在上下文菜单中使用“编辑点”命令：

选择任何增强形状时，“编辑点”命令也可在Spread Designer功能区栏中的“编辑形状”菜单里找到：

键盘快捷键增强，可为用户启用与 Excel 完全兼容的键盘快捷键

Spread .NET 14.0可为最终用户启用与 Microsoft Excel 完全兼容的键盘快捷键。

通过将FpSpread.Features.ExcelCompatibleKeyboardShortcuts设置为true，即可加载这些键盘映射，设置 FpSpread.Features.ExcelCompatibleKeyboardShortcuts = false 将删除这些键映射并恢复默认设置：

使用InputMap API创建自定义键映射，可为DisplayFormulas、ShowFormatCellsDialog、ShowCard、ShowHyperlinkDialog和EditMultipleCells这几个新的SpreadAction对象创建自定义快捷方式。

支持如 Excel 相同的多工作表选择功能

Spread .NET 支持像 Microsoft Excel 一样使用Ctrl + 单击工作表选项卡来选择多个工作表。

当多个工作表被选中时，用户可以拖放选定的工作表，并重新排列在工作簿中。如下所示，Sheet1和Sheet3都被移动到工作簿Sheet4之后：

在拖动选定的工作表时按Ctrl键，将复制这些工作表而不是将其移动：

可切换显示公式与计算结果

和 Microsoft Excel 一样，Spread .NET 支持按 Ctrl +` 来切换显示公式本身还是计算结果。

要启用此命令，必须在设计时或代码中将 FpSpread.Features.ExcelCompatibleKeyboardShortcuts 设置为 true，如下图所示：

默认显示计算结果：

点击显示公式：

Spread .NET 在新版本中增强了形状引擎，该引擎与 Microsoft Excel® 100％ 兼容，和此前的形状引擎相比，新引擎与 Excel 的兼容性更高，功能也更完善。

1. 新的形状引擎支持所有 Excel 形状：

（Spread支持所有Excel形状）

2. 新引擎支持多组形状组合，可用于创建图表、结构图和流程图：

（在Spread中创建的流程图示例）

3. 新的形状引擎可用于创建丰富的交互式界面，比如一个汽车保险索赔示例：

（使用 Spread 形状创建的汽车保险索赔示例）

要使用这个形状引擎，可以通过“属性网格”启用它：

（启用形状引擎）

也可以直接通过代码启用：

【C#】

fpSpread1.Features.EnhancedShapeEngine = true;

【VB】

fpSpread1.Features.EnhancedShapeEngine = True

Spread .NET 形状属性的绑定机制在本次发布中得到增强，支持将 AutoShapeType、TextEffect、Fill、Line、Top、Left、Height 和 Width 等属性绑定到特定的单元格中，用来设计更为丰富的交互式界面。同时，利用单元格公式的计算结果，还可以动态更新这些属性。

举例：

在上面的汽车保险索赔示例中，各形状的详细属性在 Sheet2 中如下所示：

（塑造汽车保险索赔示例的属性绑定）

通过代码来绑定形状的属性：

【C#】

 IWorkbook workbook = fpSpread1.AsWorkbook(); IShapes shapes = workbook.Worksheets[0].Shapes; // bind shape properties to cells shapes["Front"].Bindings.Add("Left", "Sheet2!B2"); shapes["Front"].Bindings.Add("Top", "Sheet2!C2"); shapes["Front"].Bindings.Add("Width", "Sheet2!D2"); shapes["Front"].Bindings.Add("Height", "Sheet2!E2"); shapes["Front"].Bindings.Add("Line", "Sheet2!F2"); 

【VB】

 Dim workbook As IWorkbook = fpSpread1.AsWorkbook Dim shapes As IShapes = workbook.Worksheets(0).Shapes   bind shape properties to cells shapes("Front").Bindings.Add("Left", "Sheet2!B2") shapes("Front").Bindings.Add("Top", "Sheet2!C2") shapes(Front").Bindings.Add("Width", "Sheet2!D2") shapes("Front").Bindings.Add("Height", "Sheet2!E2") shapes("Front").Bindings.Add("Line", "Sheet2!F2") 

可通过如下控制面板，启用此功能：

（使用属性面板启用FpSpread.Features.RichClipboard）

或者，您也可以直接在代码中设置：

【C#】

fpSpread1.Features.RichClipboard = true;

【VB】

fpSpread1.Features.RichClipboard = True;

当启用复制粘贴的增强选项时，您可以享受如下功能：

• 向 Excel 复制 Spread 设计器中选定的范围和单元格（包括源格式、公式和值）
• 从 Excel 中粘贴 Shape、Picture、Slicer （包括格式、样式、效果和文本内容）到 Spread 设计器中

您可以直接向 Spread 设计器导入、导出带有切片器的 Excel 文件，也可以直接在 Spread 设计器中插入切片器：

（Spread Designer中的插入切片器）

插入 Spread 切片器时弹出的对话框：

（插入切片器的对话框）

通过代码显示“ 插入切片器”的对话框：

【C#】

 SlicerInsertForm dlg = new SlicerInsertForm(table, new Point(25, 25)); dlg.ShowDialog(this); 

【VB】

 Dim dlg As SlicerInsertForm = new SlicerInsertForm(table, new Point(25, 25)) dlg.ShowDialog(Me) 

Spread切片器的作用与Excel相同，都是用来显示表列中的唯一值，并通过快速筛选整张表来定位该值所在的行：

（Spread为“国家/地区”表列创建的切片器）

Spread .NET 在新版本中新增了一个名为 VisualFunction 的新型自定义计算功能。

使用这个功能，您可以定义一个自定义公式函数，用来在单元格中绘制内容或应用格式，使用此功能在单元格中绘制内容类似于创建迷你图，但比创建迷你图还要简单。

此功能与 Spread 新的计算引擎和新函数类的 VisualFunction 集成在了一起。

举例：

您可以自定义绘制 QR 代码的 VisualFunction：

（显示QR代码的VisualFunction）

在公式中引用 VisualFunction 时，需要在 VisualFunction 的名称前使用前缀“ VF. ” ，并传入参数。

如上面的示例中，VisualFunction QRCODE 接收了两个参数（B1,C1），因此将 B1 到 C1 单元格中 Spread .NET 的网址生成了一个标准 QR 码。

Spread .NET 增强了对 XLOOKUP 和 XMATCH 函数的支持，这些函数目前仅在 Microsoft Excel® 的 Office Insiders 版本中可用。

和旧的 LOOKUP、VLOOKUP、HLOOKUP 和 MATCH 相比，XLOOKUP 和 XMATCH 更好，原因如下：

• XLOOKUP 和 XMATCH 可以执行垂直或水平查找（或在嵌套时都执行），具体取决于 lookup_array 的方向。
• 即使没有对数据进行排序，XLOOKUP 和 XMATCH 仍可以执行具有正确结果的非精确查找（与 HLOOKUP / VLOOKUP / MATCH 不同）。
• XLOOKUP 和 XMATCH 默认执行精确匹配查找（与 LOOKUP / HLOOKUP / VLOOKUP / MATCH 不同）。
• XLOOKUP 不需要引用包含 _ lookup_array _ 和 _ return_array _ 的全部范围，仅需引用特定范围即可。因此就计算效率而言，XLOOKUP 可以比 HLOOKUP / VLOOKUP 更高效。
• 因为使用了范围引用，XLOOKUP 在插入、删除和移动 _ lookup_array _ 或_ return_array _ 的列、行时会自动调整。
• Spread .NET 中对 XLOOKUP 和 XMATCH 进行了增强，支持 _search_mode 0 - All_ （它用来返回数组中的所有匹配项，防止当启用动态数组时，这些项因为溢出到相邻的单元格中而没有被匹配到）。

从上面的最后一点可以看出，启用动态数组功能时，为了避免遗漏数据，需要借助 _ search_mode 0-All _ ，而只有 XLOOKUP 和 XMATCH 才能支持它。

（在Spread功能区中启用“动态数组”）

通过代码启用动态数组：

【C#】

pSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray;

【VB】

fpSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray

Spread .NET 加入了公式值自动格式化的功能：

• 使公式函数的运算结果自动匹配当前的单元格样式（类似 Microsoft Excel）。
• 引用其他单元格时，将自动使用所引用单元格的样式。
• 此功能必须启用时才会生效（确保向后兼容）。

Spread .NET 提供的公式值自动格式化功能与 Excel 类似，如使用 DATE 函数计算日期时，计算结果将自动设置为日期格式。

Spread .NET 的公式值自动格式化，可以根据原始单元格格式自动格式化公式值。

举例：

在单元格 A1 中键入 1500.65，然后应用“ 货币”格式，则该单元格将显示为 $ 1500.65。此时，在单元格 A2 中键入公式“= A1”，则单元格 A2 的值也将显示为货币格式。

如果将单元格 A2 的“单元格格式”更改为会计专用，则单元格 A2 中的值将更新为 “ 会计专用格式”而不是“ 货币格式”。

此时，在单元格 B1 中键入公式“= A1”，然后将公式向下拖动到单元格 B2 中，则这两个单元格的格式均为货币类型，因为 B1、B2 单元格均引用自 A1，而 A1 的单元格格式为货币：

（根据引用单元格格式自动格式化公式值）

注：为了向后兼容，此功能默认未启用，使用时必须通过 IWorkbook.Features 来启用：

【C#】

IWorkbook.Features.AutoFormattingworkbook.Features.AutoFormatting = True

【VB】

IWorkbook.Features.AutoFormattingworkbook.Features.AutoFormatting = True

Spread .NET 可以动态调整行标题的大小，当您向下滚动表格时，该行标题会自动调整以显示完整的行号：

（向下滚动时自动调整行标题宽度）

此功能的应用场景是：在数据量非常大的电子表格中，用户向下滚动时可以查看完整的行索引号。

Spread .NET 现在使用新的重载方法 SetBackgroundPicture 在 IWorkbook 界面中为工作簿设置背景图像：

【C#】

 void IWorksheet.SetBackgroundPicture(string filename, [string contentType = null]) void IWorksheet.SetBackgroundPicture(System.IO.Stream imageStream, string contentType) 

【VB】

 Sub SetBackgroundPicture(filename As String, Optional contentType As String = Nothing) Sub SetBackgroundPicture(imageStream As System.IO.Stream, contentType As String) 

 注：背景图片必须从文件或数据流中加载，并且指定的文件类型必须是：

• 图片/ jpeg
• 图片/ png
• 图片/ tiff
• 图片/ gif
• 图片/ Bmp

（编辑公式将结构化引用插入到表格单元格中）

使用 Spread 中的 FormulaTextBox 控件编辑公式时，可以选择单元格、表格列或整个表格，并自动插入结构化引用。

注：这个功能可适用于整个表的列引用和整个表引用，但是对于使用 [@ColumnName] 语法的单元格引用，其引用的单元格必须与表单元格位于同一行中，如果表单元格在另一行中，则只能使用常规单元格引用。

Spread .NET 提供了一个新事件 BeforeRightClick，该事件用于：最终用户右键单击电子表格内部时，可以通过事件、API 来自定义上下文菜单。

您可以在此事件中调用 API（如 FpSpread.HitTest）实现：定位光标下的单击位置和对象，覆盖默认行为，并自定义上下文菜单（包括样式、自定义功能），BeforeRightClick 事件为 Spread 设计器的右键单击操作，带来了更为个性化、更加灵活的功能。

Spread .NET 在本次更新中，加入了一些令人兴奋的新示例，这些示例可以在C＃和VB中运行，并且他们已经包含在 Spread .NET 的安装程序中：

1. 汽车保险索赔示例

汽车保险索赔展示了：如何获取包含 VBA 代码和自定义形状的 Excel 工作簿（* .XLSM），并将其转换为 .NET WinForms 应用程序（Spread 设计器），该应用程序可以将新的命令（包含用户插入的 VBA 宏和其他修改项目）导出至 Excel 中。

2. 动态数组示例

该示例展示了：如何使用 Spread 的动态数组功能，以及使用动态数组的示例。您可以浏览到每个带有新公式函数 FILTER、RANDARRAY、SEQUENCE、SINGLE、SORT、SORTBY 和 UNIQUE 的工作表。

3. 公式跟踪示例

该示例展示：如何使用 Spread 新的 API 跟踪公式的源、从属单元格和引用单元格。

4. 自定义函数功能示例

该示例展示：如何实现返回数组或计算结果的自定义计算函数，该函数可与数组公式或新的动态数组功能（如果已通过 IWorkbookSet.CalculationEngine.CalcFeatures 启用）一起使用。

5. XLOOKUP 和 XMATCH 函数功能示例

该示例展示：如何使用新的 XLOOKUP 和 XMATCH 计算函数以及增强的 search_mode 0_ 来返回数组中的所有匹配项。

6. 自定义数据可视化示例

示例显示了如何创建一个新的 VisualFunction 在单元格内绘制 QR 码。

7. 切片器示例

显示了如何使用 Spread 切片器过滤工作表中的数据，以及如何设置切片器样式。

8. 形状引擎功能示例

显示了如何使用 Spread 的增强形状引擎创建流程图。

Excel 2019 推出了动态数组函数，用于简化复杂计算公式：使用动态数组，返回值将自动“输出”到相邻单元格中（未使用的）。用户只需编写一个简单的公式，而不是编写复杂的数组公式就可解决多单元格问题。

fpSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray; 

FpSpread1.AsWorkbook().WorkbookSet.CalculationEngine.CalcFeatures = GrapeCity.Spreadsheet.CalcFeatures.DynamicArray 

Spread .NET 设计器（Spread Designer） 中新增了 Formulas选项卡，包含全新的动态数组支持（默认情况下不启用）、定义名称、公式审计和用于计算的工具。

通过创建 IWorkbook，Spread .NET 为所有 GrapeCity.Spreadsheet.IWorkbook API（如 Microsoft Excel® VSTO API）提供了与 VSTO 类似的基于 1 的索引，这样做的目的是：可以轻松地将 Excel VBA 代码或旧的 Spread COM 代码（基于 1 的行和列索引部分）移植到 .NET 平台下（后者曾一直使用基于 0 的索引来支持以前版本中的所有 API，以实现 CLS）。

 IWorkbook iwb = WorkbookSet.CreateBase1Object(fpSpread1.AsWorkbook());

Dim iwb As IWorkbook = WorkbookSet.CreateBase1Object(FpSpread1.AsWorkbook())

Spread .NET 对创建自定义计算功能提供了丰富的支持，如使用AsyncFunction类创建类似RTD函数的异步函数。RTD 函数自 Excel 2002 引入，主要用于查看和更新实时数据。在 Spread .NET V12.1 中，您可以创建继承自 AsyncFunction 的自定义计算函数，实现对异步计算的支持，还可以通过各种 FunctionAttributes 来指示特殊函数的行为，如波动率或返回数组值。

本次发布版本也包括其他功能增强。关于发布更新的更多细节， 请参考发布说明。

如Excel一样，增强颜色筛选用户界面支持按“无填充”进行筛选。为减少具有大量隐藏单元下的视图状态大小，可将新属性 AllowGenerateHiddenData 设置为 false。 此属性比 AllowGetAllHiddenValue 更强大。当其设置为 false 时，表单中的所有隐藏值都保留在服务器端，从而减少视图状态的大小，并提高了页面安全性。在这种情况下，客户端接口 GetHiddenValue 和 GetHiddenCellValue 将不起作用。

本次发布版本也包括其他功能增强。关于发布更新的更多细节， 请参考发布说明。

新增的单元格验证和增强的数据验证，为用户数据输入提供了强大的新选项，并支持在 Excel 文档中保存和加载数据验证。支持了 Excel 中提供的 8 种数据验证类型，包含：任何值、整数、小数、序列、日期、时间和文本长度以及自定义。

新增 130 多个计算公式，使公式总数达到了 462 个。新支持数组公式（使用 Ctrl + Shift + Enter 输入）可以实现高级矩阵和数组计算。当用户输入创建循环引用的公式时，触发新添加的 CircularFormula 事件。

本次增加 spread 所有支持公式一览表。

新增保护工作簿结构功能，并可设置密码。该功能保护工作簿结构并防止用户删除或重新排序工作表。

新增接口来获取和设置文档属性，包含：标题，主题，作者，公司等。

新的增强型 HyperLinkCellType 现在可以很好地处理排序和过滤功能。

支持从行头单元格拖放，即可直接在用户界面中移动行的功能。

本次发布版本也包括其他功能增强。关于发布更新的更多细节， 请参考发布说明。