# 在 Python via Java 中的演示文稿中应用图表工作表公式

> 在 Aspose.Slides for Python via Java 图表工作表中应用 Excel 样式公式，重新计算数值，并在 PowerPoint 图表中使用结果。

Source: https://docs.aspose.com/slides/zh/python-java/chart-worksheet-formulas/
Updated: 2026-09-11

## **概述**

PowerPoint 图表通常将其源数据存储在嵌入式工作表中。在 Aspose.Slides for Python via Java 中，您可以通过图表数据工作簿访问该工作表，写入输入值，为单元格分配公式，计算受支持的公式，并将计算得到的单元格用作图表数据。

本文说明了完整的公式工作流：创建图表、填充其工作表、分配 A1 样式或 R1C1 样式公式、重新计算、读取计算值、将这些单元格连接到图表系列并保存演示文稿。它还描述了受支持的公式语法、内置函数子集、缓存值、不受支持的公式以及电子表格特定错误。

## **图表工作表和公式**

图表工作表包含图表使用的类别、系列名称和数值。在 PowerPoint 中，您可以通过打开图表数据编辑器来检查工作表：

![打开嵌入式工作表的 PowerPoint 图表，显示类别和系列数据](chart-worksheet-formulas_1.png)

在 Aspose.Slides 中，工作表通过[ChartDataWorkbook](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/)类公开。使用[ChartDataCell.setFormula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setFormula)设置 A1 样式公式，使用[ChartDataCell.setR1C1Formula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setR1C1Formula)设置 R1C1 样式公式。更改输入单元格或公式后，调用[ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas)重新计算受支持的公式并更新相应的单元格值。

计算后的单元格仍通过[ChartDataCell.getValue](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#getValue)公开其结果。当您需要在代码中检查公式结果或将单元格用作图表数据点时，这一点尤其重要。

## **创建图表并计算工作表公式**

以下示例演示了端到端工作流。它创建一个簇状柱形图，清除示例数据，写入季度收入和支出值，使用公式计算利润，读取结果，将计算得到的单元格用作图表值，并保存演示文稿。

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, Presentation, SaveFormat

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 600, 350)
    workbook = chart.getChartData().getChartDataWorkbook()
    worksheet_index = 0

    chart.getChartData().getSeries().clear()
    chart.getChartData().getCategories().clear()
    workbook.clear(worksheet_index)

    category1 = workbook.getCell(worksheet_index, "A2", "Q1")
    category2 = workbook.getCell(worksheet_index, "A3", "Q2")
    category3 = workbook.getCell(worksheet_index, "A4", "Q3")

    workbook.getCell(worksheet_index, "B1", "Revenue")
    workbook.getCell(worksheet_index, "C1", "Expenses")
    workbook.getCell(worksheet_index, "D1", "Profit")

    workbook.getCell(worksheet_index, "B2").setValue(120.0)
    workbook.getCell(worksheet_index, "C2").setValue(80.0)
    workbook.getCell(worksheet_index, "B3").setValue(150.0)
    workbook.getCell(worksheet_index, "C3").setValue(95.0)
    workbook.getCell(worksheet_index, "B4").setValue(135.0)
    workbook.getCell(worksheet_index, "C4").setValue(110.0)

    profit1 = workbook.getCell(worksheet_index, "D2")
    profit2 = workbook.getCell(worksheet_index, "D3")
    profit3 = workbook.getCell(worksheet_index, "D4")

    profit1.setFormula("B2-C2")
    profit2.setFormula("B3-C3")
    profit3.setFormula("B4-C4")

    workbook.calculateFormulas()

    q1_profit = float(profit1.getValue()) # 40
    q2_profit = float(profit2.getValue()) # 55
    q3_profit = float(profit3.getValue()) # 25

    print("Q1 profit: ", q1_profit)
    print("Q2 profit: ", q2_profit)
    print("Q3 profit: ", q3_profit)

    chart.getChartData().getCategories().add(category1)
    chart.getChartData().getCategories().add(category2)
    chart.getChartData().getCategories().add(category3)

    profit_series = chart.getChartData().getSeries().add(workbook.getCell(worksheet_index, "D1"), chart.getType())
    profit_series.getDataPoints().addDataPointForBarSeries(profit1)
    profit_series.getDataPoints().addDataPointForBarSeries(profit2)
    profit_series.getDataPoints().addDataPointForBarSeries(profit3)
    profit_series.getLabels().getDefaultDataLabelFormat().setShowValue(True)

    presentation.save("chart-formulas.pptx", SaveFormat.Pptx)
finally:
    presentation.dispose()
```

图表数据点引用 `D2:D4`，因此图表使用计算得到的利润值。在此工作流中没有单独的图表刷新调用：先重新计算工作簿，然后使用或保存指向计算单元格的图表数据。

## **使用 A1 样式公式**

A1 表示法使用字母标识列，使用数字标识行。通过[ChartDataCell.setFormula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setFormula)分配 A1 样式表达式。

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, Presentation

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300)
    workbook = chart.getChartData().getChartDataWorkbook()

    workbook.getCell(0, "C3").setValue(10)
    workbook.getCell(0, "F2").setValue(2)
    workbook.getCell(0, "G2").setValue(3)
    workbook.getCell(0, "H2").setValue(4)

    cell = workbook.getCell(0, "A2")
    cell.setFormula("C3+SUM(F2:H2)")

    workbook.calculateFormulas()

    value = cell.getValue() # 19
finally:
    presentation.dispose()
```

常见的 A1 引用形式如下：

| 引用 | 相对 | 绝对 | 混合 |
|---|---|---|---|
| 单元格 | `A2` | `$A$2` | `A$2`, `$A2` |
| 行 | `2:2` | `$2:$2` | — |
| 列 | `A:A` | `$A:$A` | — |
| 区域 | `A2:C4` | `$A$2:$C$4` | `A$2:$C4`, `$A2:C$4` |

相对引用在公式被移动或复制时会改变。绝对引用固定两个坐标，而混合引用仅固定行或列。

## **使用 R1C1 样式公式**

R1C1 表示法使用数字标识行和列。相对引用使用方括号中的偏移量。通过[ChartDataCell.setR1C1Formula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setR1C1Formula)分配此语法。

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, Presentation

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300)
    workbook = chart.getChartData().getChartDataWorkbook()

    workbook.getCell(0, "B2").setValue(12)
    workbook.getCell(0, "C2").setValue(5)

    cell = workbook.getCell(0, "D2")
    cell.setR1C1Formula("RC[-2]-RC[-1]")

    workbook.calculateFormulas()

    value = cell.getValue() # 7
finally:
    presentation.dispose()
```

常见的 R1C1 引用形式如下：

| 引用 | 相对 | 绝对 | 混合 |
|---|---|---|---|
| 单元格 | `R[2]C[3]` | `R2C3` | `R2C[3]`, `R[2]C3` |
| 行 | `R[2]` | `R2` | — |
| 列 | `C[3]` | `C3` | — |
| 区域 | `R[2]C[3]:R[5]C[7]` | `R2C3:R5C7` | `R2C3:R[5]C[7]`, `R[2]C3:R5C[7]` |

例如，在单元格 `D2` 中，`RC[-2]` 表示同一行左侧两列的单元格 (`B2`)。

## **公式常量和运算符**

内置公式求值器支持逻辑值、数值字面量、字符串、电子表格错误值、算术运算符和比较运算符。

### **常量和字面量**

| 类型 | 示例 | 备注 |
|---|---|---|
| 逻辑 | `TRUE`, `FALSE` | 可直接用于逻辑表达式，例如 `A2=TRUE`。 |
| 数值 | `1`, `0.5`, `.3`, `1E-2` | 支持普通和科学计数法。 |
| 字符串 | `"abc"`, `"2/3/2020 12:00"` | 文本字面量在公式中用双引号括起。 |
| 错误结果 | `#DIV/0!`, `#N/A`, `#REF!` | 有效公式可能评估为电子表格错误值而非正常结果。 |

下面的示例使用了多种常量类型：

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import ChartType, Presentation

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300)
    workbook = chart.getChartData().getChartDataWorkbook()

    workbook.getCell(0, "A2").setValue(False)
    workbook.getCell(0, "B2").setFormula("A2=TRUE")
    workbook.getCell(0, "C2").setFormula("1+0.5")
    workbook.getCell(0, "D2").setFormula(".3*1E-2")
    workbook.getCell(0, "E2").setFormula("\"abc\"")
    workbook.getCell(0, "F2").setFormula("2/0")

    workbook.calculateFormulas()

    logical_value = workbook.getCell(0, "B2").getValue() # False
    numeric_value = workbook.getCell(0, "C2").getValue() # 1.5
    scientific_value = workbook.getCell(0, "D2").getValue() # 0.003
    string_value = workbook.getCell(0, "E2").getValue() # abc
    error_value = workbook.getCell(0, "F2").getValue() # #DIV/0!
finally:
    presentation.dispose()
```

### **算术运算符**

| 运算符 | 含义 | 示例 |
|---|---|---|
| `+` | 加法或一元加号 | `2+3` |
| `-` | 减法或取负 | `2-3`, `-3` |
| `*` | 乘法 | `2*3` |
| `/` | 除法 | `2/3` |
| `%` | 百分比 | `30%` |
| `^` | 幂运算 | `2^3` |

使用括号可以明确求值顺序，例如 `(A2+B2)*C2`。

### **比较运算符**

比较表达式返回逻辑值。

| 运算符 | 含义 | 示例 |
|---|---|---|
| `=` | 等于 | `A2=3` |
| `<>` | 不等于 | `A2<>3` |
| `>` | 大于 | `A2>3` |
| `>=` | 大于等于 | `A2>=3` |
| `<` | 小于 | `A2<3` |
| `<=` | 小于等于 | `A2<=3` |

## **受支持的预定义函数**

Aspose.Slides 为图表工作表提供了内置公式求值器，但它并非完整的 Excel 计算引擎。文档中列出的函数集仅限于以下函数。不要假设任意 Excel 函数都能通过[ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas)重新计算。

| 函数 | 用途或支持的形式 | 示例 |
|---|---|---|
| `ABS` | 绝对值 | `ABS(A2)` |
| `AVERAGE` | 算术平均值 | `AVERAGE(B2:B5)` |
| `CEILING` | 向上取整到指定倍数 | `CEILING(A2,5)` |
| `CHOOSE` | 按索引选择值 | `CHOOSE(A2,"Low","High")` |
| `CONCAT` | 合并文本值 | `CONCAT(A2,B2)` |
| `CONCATENATE` | 合并文本值 | `CONCATENATE(A2," ",B2)` |
| `DATE` | 使用 1900 日期系统创建日期值 | `DATE(2026,8,19)` |
| `DAYS` | 返回两个日期之间的天数 | `DAYS(B2,A2)` |
| `FIND` | 在另一个文本中查找文本 | `FIND("-",A2)` |
| `FINDB` | 按字节搜索文本 | `FINDB("a",A2)` |
| `IF` | 条件结果 | `IF(A2>0,A2,0)` |
| `INDEX` | 引用形式 | `INDEX(A2:C4,2,3)` |
| `LOOKUP` | 向量形式 | `LOOKUP(A2,B2:B5,C2:C5)` |
| `MATCH` | 向量形式 | `MATCH(A2,B2:B5,0)` |
| `MAX` | 最大值 | `MAX(B2:B5)` |
| `SUM` | 求和 | `SUM(B2:B5)` |
| `VLOOKUP` | 垂直查找 | `VLOOKUP(A2,B2:D10,3,FALSE)` |

表中显示的限制非常重要：`INDEX` 以引用形式记录，而 `LOOKUP` 和 `MATCH` 以向量形式记录。`DATE` 使用 1900 日期系统。未在此列出的功能和函数应视为 Aspose.Slides 公式求值器不支持，除非另有文档说明。

## **使用首选文化计算公式**

某些工作簿函数会根据文化特定规则解释文本。这对使用双字节字符集（DBCS）的语言尤为重要。若要正确计算此类公式，请创建[LoadOptions](https://reference.aspose.com/slides/zh/python-java/aspose.slides/loadoptions/)，通过[SpreadsheetOptions.setPreferredCulture](https://reference.aspose.com/slides/zh/python-java/aspose.slides/spreadsheetoptions/#setPreferredCulture)设置首选文化，使用[LoadOptions.setSpreadsheetOptions](https://reference.aspose.com/slides/zh/python-java/aspose.slides/loadoptions/#setSpreadsheetOptions)指定电子表格选项，然后加载演示文稿。

以下示例选择日语文化，使用配置好的加载选项打开演示文稿，并为每个图表工作簿调用[ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas)：

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import Chart, LoadOptions, Presentation, SpreadsheetOptions
from java.util import Locale

japanese_culture = Locale.forLanguageTag("ja-JP")

spreadsheet_options = SpreadsheetOptions()
spreadsheet_options.setPreferredCulture(japanese_culture)

load_options = LoadOptions()
load_options.setSpreadsheetOptions(spreadsheet_options)

presentation = Presentation("presentation.pptx", load_options)
try:
    for slide in presentation.getSlides():
        for shape in slide.getShapes():
            if isinstance(shape, Chart):
                shape.getChartData().getChartDataWorkbook().calculateFormulas()
finally:
    presentation.dispose()
```

首选文化是演示文稿加载配置的一部分，因此应在创建[Presentation](https://reference.aspose.com/slides/zh/python-java/aspose.slides/presentation/)实例之前指定。使用工作簿公式期望的文化，例如对应日本 DBCS 计算规则的 `ja-JP`。

## **重新计算和缓存值**

电子表格文件通常同时存储公式及其最近计算的值。Aspose.Slides 可以在加载演示文稿且相关图表数据未改变时，从[ChartDataCell.getValue](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#getValue)读取缓存值。

更改输入单元格或公式后，不要依赖旧的缓存结果。读取计算值或保存依赖这些值的图表数据前，请调用[ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas)。

对于不在受支持子集内的公式，Aspose.Slides 可能无法解析公式或确定其依赖关系。如果工作簿已被修改，之前的缓存值不能再视为可靠。在这种情况下，读取包含不受支持数据的单元格值可能会抛出[CellUnsupportedDataException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellunsupporteddataexception/)。

如果您的图表依赖 Aspose.Slides 不评估的 Excel 函数，请使用支持这些函数的电子表格引擎计算公式，并将结果写回图表工作簿。不要用猜测的值替换不受支持的公式。

## **处理公式错误**

需要区分两种不同的问题。

公式本身有效，但会产生诸如 `#DIV/0!`、`#N/A`、`#NAME?`、`#NULL!`、`#NUM!`、`#REF!` 或 `#VALUE!` 的电子表格错误结果。在这种情况下，错误标记是单元格结果，可通过[ChartDataCell.getValue](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#getValue)返回。

公式也可能在解析、引用、依赖或受支持数据层面失败。Aspose.Slides 为这些情况提供了特定的电子表格异常： [CellInvalidFormulaException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellinvalidformulaexception/)、[CellInvalidReferenceException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellinvalidreferenceexception/)、[CellCircularReferenceException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellcircularreferenceexception/) 和 [CellUnsupportedDataException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellunsupporteddataexception/)。

当公式来自模板或用户输入时，请在重新计算和访问数值时捕获这些异常：

```python
import jpype
import asposeslides

if not jpype.isJVMStarted():
    jpype.startJVM()

from asposeslides.api import CellCircularReferenceException, CellInvalidFormulaException, CellInvalidReferenceException, CellUnsupportedDataException, ChartType, Presentation

presentation = Presentation()
try:
    slide = presentation.getSlides().get_Item(0)
    chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 500, 300)
    workbook = chart.getChartData().getChartDataWorkbook()
    cell = workbook.getCell(0, "A2")
    cell.setFormula("SUM(B2:B5)")

    try:
        workbook.calculateFormulas()
        print(cell.getValue())
    except CellInvalidFormulaException as ex:
        print("Invalid formula: " + str(ex.getMessage()))
    except CellInvalidReferenceException as ex:
        print("Invalid cell reference: " + str(ex.getMessage()))
    except CellCircularReferenceException as ex:
        print("Circular reference: " + str(ex.getMessage()))
    except CellUnsupportedDataException as ex:
        print("Unsupported spreadsheet data: " + str(ex.getMessage()))
finally:
    presentation.dispose()
```

## **实际限制**

图表工作表中的公式支持旨在覆盖定义好的子集，而非完整的 Excel 兼容性。在设计报表工作流时请牢记这些约束：

- 仅使用文档中列出的常量、运算符、引用和函数，以便 Aspose.Slides 能重新计算公式。
- 在修改公式结果依赖的单元格后进行重新计算。
- 将加载的演示文稿中的缓存值视为快照，而不是编辑后重新计算的替代方案。
- 在依赖现有模板的计算结果之前，对模板中的公式进行测试，尤其是当它们使用未列出的函数时。
- 对于需要完整电子表格计算引擎的公式，请在外部计算后将结果写回图表工作簿。

## **常见问答**

**[ChartDataCell.setFormula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setFormula) 与 [ChartDataCell.setR1C1Formula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setR1C1Formula) 有何区别？**

[ChartDataCell.setFormula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setFormula) 存储 A1 样式表达式，例如 `B2-C2`。而 [ChartDataCell.setR1C1Formula](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#setR1C1Formula) 存储 R1C1 样式表达式，例如 `RC[-2]-RC[-1]`。请使用最符合您生成或复制公式方式的表示法。

**在计算后，我需要读取单元格本身还是它的值？**

[ChartDataWorkbook.getCell](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#getCell) 返回一个 [ChartDataCell](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/)。在重新计算后，调用该单元格的 [ChartDataCell.getValue](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdatacell/#getValue) 方法即可获取计算结果。

**何时应调用 [ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas)？**

在更改输入值或公式后，并在依赖计算结果之前调用 [ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas)。这会更新内置求值器支持的公式的值。

**Aspose.Slides 是否支持所有 Excel 函数？**

不支持。内置求值器仅支持文档中列出的子集。未列出的函数不应假设能够正确重新计算。如果需要完整的 Excel 公式兼容性，请使用适当的电子表格引擎进行计算并将最终值写入图表工作簿。

**如果加载的演示文稿包含不受支持的公式会怎样？**

如果图表数据未更改，工作簿可能仍保留先前计算的缓存值。关联数据被修改后，该缓存值可能不再有效。尝试访问无法处理的公式单元格可能会抛出 [CellUnsupportedDataException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellunsupporteddataexception/)。

**公式错误值与异常是同一回事吗？**

不是。`#DIV/0!` 等结果是有效计算产生的电子表格值。像 [CellInvalidFormulaException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellinvalidformulaexception/) 或 [CellCircularReferenceException](https://reference.aspose.com/slides/zh/python-java/aspose.slides/cellcircularreferenceexception/) 之类的异常表明公式无法正常处理。

**当公式单元格更改时，图表会自动更新吗？**

图表系列可以引用工作簿单元格。先重新计算工作簿，然后保存或呈现演示文稿。如果图表数据点引用了计算后的单元格，图表会使用这些更新后的数值；此工作流不需要单独的图表刷新方法。

**图表可以使用外部 Excel 工作簿吗？**

可以，图表数据可以通过图表数据 API 配置为使用外部工作簿。然而，本文描述的公式计算工作流仅针对图表数据工作簿以及 Aspose.Slides 评估的公式子集。不要假设 [ChartDataWorkbook.calculateFormulas](https://reference.aspose.com/slides/zh/python-java/aspose.slides/chartdataworkbook/#calculateFormulas) 能完整重新计算外部 XLSX 文件中的任意公式。

**我可以使用引用其他工作表或工作簿的公式吗？**

Excel 样式的引用可以出现在图表工作簿中，但公式求值受限于支持的解析器和函数集。如果跨工作表或外部引用是必需的，请在目标 Aspose.Slides 版本中验证该公式的准确性。对于需要广泛 Excel 引用兼容性的工作流，请在外部计算工作簿并将解析后的数值写回图表数据。

**公式字符串需要以 `=` 开头吗？**

Aspose.Slides API 示例中分配的表达式如 `B2-C2` 或 `SUM(B2:B5)` 并不带前导 `=`。采用此形式可使生成的公式与文档中的 API 示例保持一致。