图表工作表公式

关于演示中的图表电子表格公式

图表电子表格（或图表工作表）是在演示中图表的数据源。图表电子表格包含以图形方式表示的数据显示。当您在 PowerPoint 中创建图表时，与此图表相关的工作表也会自动创建。图表工作表为所有类型的图表创建：折线图、条形图、旭日图、饼图等。要在 PowerPoint 中查看图表电子表格，您应该双击图表：

todo:image_alt_text

图表电子表格包含图表元素的名称（类别名称：Category1，系列名称）和一个包含与这些类别和系列相对应的数值数据的表。默认情况下，当您创建一个新的图表时 - 图表电子表格数据将设置为默认数据。然后，您可以手动更改工作表中的电子表格数据。

通常，图表表示复杂数据（例如，金融分析师、科学分析师），具有从其他单元格的值或其他动态数据计算的单元格。手动计算单元格值并将其硬编码到单元格中，使得将来更改它变得困难。如果您更改某个单元格的值，则所有依赖于它的单元格也需要更新。此外，表格数据可能依赖于其他表格的数据，从而创建一个复杂的演示数据方案，需要以简单灵活的方式进行更新。

演示中的图表电子表格公式 是用于自动计算和更新图表电子表格数据的表达式。电子表格公式定义了特定单元格或一组单元格的数据计算逻辑。电子表格公式是使用单元格引用、数学函数、逻辑运算符、算术运算符、转换函数、字符串常量等的数学公式或逻辑公式。公式的定义写入一个单元格中，这个单元格不包含一个简单的值。电子表格公式计算值并返回，然后这个值被赋值给单元格。演示中的图表电子表格公式实际上与 Excel 公式相同，并且在实现中支持相同的默认函数、运算符和常量。

在 Aspose.Slides 中，图表电子表格通过 Chart.getChartData.getChartDataWorkbook 方法表示 IChartDataWorkbook 类型。 电子表格公式可以通过 IChartDataCell.setFormula 方法进行赋值和更改。 Aspose.Slides 支持以下功能用于公式：

  • 逻辑常量
  • 数值常量
  • 字符串常量
  • 错误常量
  • 算术运算符
  • 比较运算符
  • A1 风格单元格引用
  • R1C1 风格单元格引用
  • 预定义函数

通常，电子表格存储最后计算的公式值。如果在演示加载后，图表数据没有更改 - IChartDataCell.getValue 方法将在读取时返回这些值。但如果电子表格数据在读取时发生了更改 ChartDataCell.Value 属性将会抛出 CellUnsupportedDataException 用于不支持的公式。这是因为当公式成功解析时，会确定单元格依赖关系和最后值的正确性。但是，如果公式无法解析，则无法保证单元格值的正确性。

将图表电子表格公式添加到演示中

首先，通过 IShapeCollection.getShapes.addChart 在新演示的第一张幻灯片上添加一个图表。 图表的工作表会自动创建，并且可以通过 Chart.getChartData.getChartDataWorkbook 方法访问：

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::ClusteredColumn, 150, 150, 500, 300);
    $workbook = $chart->getChartData()->getChartDataWorkbook();
    # ...
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

现在，可以使用 IChartDataCell.setValue 属性以 Object 类型在单元格中写入一些值，这表示您可以将任何值设置为该属性：

  $workbook->getCell(0, "F2")->setValue(-2.5);
  $workbook->getCell(0, "G3")->setValue(6.3);
  $workbook->getCell(0, "H4")->setValue(3);

现在，为单元格写入公式，可以使用 IChartDataCell.setFormula 方法：

注意: IChartDataCell.setFormula 方法用于设置 A1 风格单元格引用。

要设置 R1C1Formula 单元格引用，可以使用 IChartDataCell.setR1C1Formula 方法：

然后，如果您尝试从单元格 B2 和 C2 读取值，它们将被计算：

  $value1 = $cell1->getValue();// 7.8

  $value2 = $cell2->getValue();// 2.1

逻辑常量

您可以在单元格公式中使用逻辑常量，例如 FALSE 和 TRUE：

  $workbook->getCell(0, "A2")->setValue(false);
  $cell = $workbook->getCell(0, "B2");
  $cell->setFormula("A2 = TRUE");
  $value = $cell->getValue();// 的值包含布尔值 "false"

数值常量

数字可以用常规或科学表示法在图表电子表格公式中使用：

  $workbook->getCell(0, "A2")->setFormula("1 + 0.5");
  $workbook->getCell(0, "B2")->setFormula(".3 * 1E-2");

字符串常量

字符串（或文本）常量是以原样使用的特定值，并且不会改变。字符串常量可以是：日期、文本、数字等：

  $workbook->getCell(0, "A2")->setFormula("\"abc\"");
  $workbook->getCell(0, "B2")->setFormula("\"2/3/2020 12:00\"");

错误常量

有时通过公式计算结果是不可能的。在这种情况下，错误代码将在单元格中显示，而不是其值。每种类型的错误都有特定的代码：

  • #DIV/0! - 公式尝试除以零。
  • #GETTING_DATA - 在单元格上显示，直到其值计算完成。
  • #N/A - 信息丢失或不可用。一些原因可能是：公式中使用的单元格为空、额外的空格字符、拼写错误等。
  • #NAME? - 无法通过名称找到特定单元格或其他公式对象。 
  • #NULL! - 当公式中存在错误时可能会出现，例如：  (,) 或空格字符用于代替冒号 (:).
  • #NUM! - 公式中的数字可能无效、过长或过小等。
  • #REF! - 无效的单元格引用。
  • #VALUE! - 意外值类型。例如，将字符串值设置为数值单元格。
  $cell = $workbook->getCell(0, "A2");
  $cell->setFormula("2 / 0");
  $value = $cell->getValue();// 的值包含字符串 "#DIV/0!"

算术运算符

您可以在图表工作表公式中使用所有算术运算符：

运算符  含义  示例
+ (加号)  加法或一元加法 2 + 3
- (减号)  减法或取反  2 - 3
-3
* (星号) 乘法  2 * 3
/ (斜杠) 除法  2 / 3
% (百分号)  百分比  30%
^ (插入符号)  指数  2 ^ 3

注意: 要更改计算的顺序，请在公式中需要优先计算的部分用括号括起来。

比较运算符

您可以使用比较运算符比较单元格的值。当使用这些运算符比较两个值时，结果是逻辑值 TRUE 或 FALSE：

运算符  含义  含义 
= (等号)  等于  A2 = 3
<> (不等号)  不等于 A2 <> 3
> (大于号)  大于 A2 > 3
>= (大于或等于号) 大于或等于 A2 >= 3
< (小于号) 小于 A2 < 3
<= (小于或等于号) 小于或等于 A2 <= 3

A1 风格单元格引用

A1 风格单元格引用 用于工作表，其中列有字母标识符（例如 “A"）而行有数字标识符（例如 “1）。A1 风格单元格引用可以以以下方式使用：

单元格引用 示例
绝对  相对  混合
单元格  $A$2  A2

A$2

$A2
行  $2:$2  2:2  -
列  $A:$A  A:A  -
范围  $A$2:$C$4  A2:C4

$A$2:C4

A$2:$C4

以下是如何在公式中使用 A1 风格单元格引用的示例：

  $workbook->getCell(0, "A2")->setFormula("C3 + SUM(F2:H5)");

R1C1 风格单元格引用

R1C1 风格单元格引用 用于工作表，其中行和列都有数字标识符。R1C1 风格单元格引用可以以以下方式使用：

单元格引用 示例
绝对  相对  混合
单元格  R2C3 R[2]C[3] R2C[3]
R[2]C3
行  R2 R[2] -
列  C3 C[3] -
范围  R2C3:R5C7 R[2]C[3]:R[5]C[7]  R2C3:R[5]C[7]
R[2]C3:R5C[7]

以下是如何在公式中使用 R1C1 风格单元格引用的示例：

  $workbook->getCell(0, "A2")->setR1C1Formula("R2C4 + SUM(R5C6:R7C9)");

预定义函数

有一些预定义函数可以在公式中使用，以简化其实现。这些函数封装了最常用的操作，例如：

  • ABS
  • AVERAGE
  • CEILING
  • CHOOSE
  • CONCAT
  • CONCATENATE
  • DATE (1900 日期系统)
  • DAYS
  • FIND
  • FINDB
  • IF
  • INDEX (引用形式)
  • LOOKUP (向量形式)
  • MATCH (向量形式)
  • MAX
  • SUM
  • VLOOKUP
图表格式化 动画图表