计算模式

SpreadJS 会在依赖值（公式中引用的单元格、值或名称）发生变化时自动更新公式。然而，如果你希望控制何时重新计算公式，而不是在引用单元格发生变化后立即进行计算，你可以将自动计算切换为手动计算。SpreadJS API 中的 CalculationMode 枚举允许你设置自动或手动的计算选项。

当 CalculationMode 设置为 auto 时（默认模式），SpreadJS 会在每次引用的单元格发生改变时自动计算所有被修改的单元格。例如，在剪切粘贴或输入单元格时。

需要注意的是，SpreadJS 将修改过的单元格视为脏单元格，并且需要进行重新计算。

另一方面，当 CalculationMode 设置为手动（manual） 时，SpreadJS 仅在你明确请求时计算和更新公式。

这在你有一个包含许多复杂公式的大型工作表中，并且希望避免频繁的重新计算以提高性能和响应速度时非常有用。例如，在剪切或粘贴值时，SpreadJS会重置公式和单元格的值，但不会重新计算任何公式。

注意：SpreadJS 在导出到 Excel 时支持 CalculationMode 选项。

以下代码示例展示了如何在初始化工作簿时设置手动计算选项。

// Switch to manual mode when initializing the workbook.
var spread = new GC.Spread.Sheets.Workbook(document.getElementById("ss"), {calculationMode: GC.Spread.Sheets.CalculationMode.manual});

// Or
spread.options.calculationMode = GC.Spread.Sheets.CalculationMode.manual;

一旦切换到手动计算模式，你需要使用calculate()方法手动更新工作表中的公式，该方法接受CalculationType枚举值作为参数。

CalculationType枚举指定计算类型，其可用成员如下所示：

成员	描述
`all`	将范围内的所有单元格标记为需要进行计算。这是默认的计算类型。
`rebuild`	重建范围内的所有公式，并将它们标记为需要进行计算。
`minimal`	将公式标记为需要进行计算，但不会标记易变单元格和循环引用单元格。
`regular`	将易变单元格和循环引用单元格标记为需要进行计算。

请查看下表，了解当使用自动和手动计算模式时，SpreadJS在不同的公式及其依赖关系上的行为。

使用的公式	自动计算（默认模式）	手动计算
`suspendCalcService(true)`	禁用计算引擎，不对任何单元格进行重新计算。
`resumeCalcService(false)`	启用计算引擎，并计算易变单元格、循环引用单元格和脏单元格。	启用计算引擎，标记易变单元格为脏单元格，但不计算脏单元格。
`resumeCalcService(true)`	启用计算引擎，并计算所有单元格。	启用计算引擎，将所有单元格标记为脏单元格，但不计算脏单元格。
`resumeCalcService(false)` 和 `sheet.setFormula`	计算公式及其依赖关系。	计算公式。
`resumeCalcService(false)` 和 `spread.calculate()`	计算所有打开的工作表中的所有公式。
`resumeCalcService(false)` 和 `spread.calculate(GC.Spread.Sheets.CalculationType.regular)`	计算所有被标记为脏单元格的单元格，即依赖于易变或更改的数据的单元格，以及通过编程方式标记为脏单元格的单元格。
`resumeCalcService(false)` 和 `spread.calculate(GC.Spread.Sheets.CalculationType.rebuild)`	重建工作表中的所有公式，然后计算它们。
`resumeCalcService(false)` 和 `spread.calculate(null, “Sheet1“)`	将Sheet1中的所有公式标记为脏单元格，并标记范围之外的依赖关系为脏单元格。计算所有脏单元格。	将Sheet1中的所有公式标记为脏单元格，并标记范围之外的依赖关系为脏单元格。计算Sheet1中的脏单元格。保持其他单元格的脏状态。

注意：从SpreadJS v16.2版本开始，已弃用了 sheet.recalcAll() 方法来重新计算单元格中的公式。你可以使用 spread.calculate() 来替代。

以上是在SpreadJS中使用不同计算模式和类型进行各种计算的示例代码。

spread.sheets[0].setFormula(0,0,"RAND()"); // Sheet1!A1
spread.sheets[0].setFormula(1,0,"=Sheet2!A1"); // Sheet1!A2
spread.sheets[0].setFormula(2,0,"=1+2"); // Sheet1!A3
spread.sheets[1].setFormula(0,0,"RAND()"); // Sheet2!A1
spread.sheets[1].setFormula(1,0,"=Sheet1!A1"); // Sheet2!A2

// 重新计算所有单元格。
spread.calculate(); 
spread.calculate(GC.Spread.Sheets.CalculationType.regular); 

// Sheet1!A1和Sheet2!A2将被计算为新的数字，并计算Sheet1!A2和Sheet1!A3。
spread.calculate(GC.Spread.Sheets.CalculationType.all, "Sheet1"); 

// Sheet1!A1和Sheet2!A2将被计算为新的数字。
spread.calculate(GC.Spread.Sheets.CalculationType.regular, "Sheet1!A1"); 

// 没有单元格会被计算。
spread.calculate(GC.Spread.Sheets.CalculationType.regular, "Sheet1!A2"); 

// Sheet1!A1将被计算为新的数字，Sheet1!A2和Sheet1!A3将被计算但不会发生变化，Sheet2!A2在手动模式下保持脏状态。
spread.calculate(GC.Spread.Sheets.CalculationType.all, "Sheet1"); 

// Sheet1!A1将被计算为新的数字，Sheet2!A2在手动模式下保持脏状态。
spread.calculate(GC.Spread.Sheets.CalculationType.regular, "Sheet1"); 

// Sheet2!A2将被计算，因为它是脏的。
spread.calculate(GC.Spread.Sheets.CalculationType.minimal);

使用设计器

您可以使用 SpreadJS 设计器设置所需的计算选项。在公式 > 计算选项卡组中，选择 "计算选项" 按钮。

在手动计算模式下，您需要选择要重新计算的工作簿部分。

单击 "Calculate Now" 按钮以更新所有打开的工作表中的更改。
如果只想在同一工作表中反映修改，请单击 "Calculate Sheet" 按钮。

CalculateNow.e35c34

如果您只想在同一工作表中反映修改，请单击“Calculate Sheet”按钮。

CalculateSheet.389d98