使用 PHP 定制树图和旭形图中的数据点

在 PowerPoint 图表的其他类型中，有两种“层级”类型——Treemap 和 Sunburst 图表（也称为 Sunburst Graph、Sunburst Diagram、Radial Chart、Radial Graph 或 Multi Level Pie Chart）。这些图表以树形结构显示层级数据——从叶子到分支的顶部。叶子由系列数据点定义，每个后续的嵌套分组层级由相应的类别定义。Aspose.Slides for PHP via Java 允许对 Sunburst 图表和 Treemap 的数据点进行格式化。

下面是一个 Sunburst 图表，其中 Series1 列中的数据定义叶子节点，而其他列定义层级数据点：

todo:image_alt_text

让我们开始向演示文稿中添加一个新的 Sunburst 图表：

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Sunburst, 100, 100, 450, 400);
    # ...
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

如果需要对图表的数据点进行格式化，我们应该使用以下内容：

IChartDataPointLevelsManager, IChartDataPointLevel 类和 IChartDataPoint.getDataPointLevels 方法提供对 Treemap 和 Sunburst 图表的数据点进行格式化的访问。

IChartDataPointLevelsManager 用于访问多层级类别——它表示 IChartDataPointLevel 对象的容器。

基本上它是 IChartCategoryLevelsManager 的包装器，并添加了针对数据点的特定属性。

IChartDataPointLevel 类有两个方法： getFormat 和 getDataLabel，它们提供对相应设置的访问。

显示数据点的值

显示 “Leaf 4” 数据点的值：

  $dataPoints = $chart->getChartData()->getSeries()->get_Item(0)->getDataPoints();
  $dataPoints->get_Item(3)->getDataPointLevels()->get_Item(0)->getLabel()->getDataLabelFormat()->setShowValue(true);

todo:image_alt_text

设置数据点标签和颜色

将 “Branch 1” 数据标签设置为显示系列名称（“Series1”）而非类别名称。然后将文字颜色设为黄色：

  $branch1Label = $dataPoints->get_Item(0)->getDataPointLevels()->get_Item(0)->getLabel();
  $branch1Label->getDataLabelFormat()->setShowCategoryName(false);
  $branch1Label->getDataLabelFormat()->setShowSeriesName(true);
  $branch1Label->getDataLabelFormat()->getTextFormat()->getPortionFormat()->getFillFormat()->setFillType(FillType::Solid);
  $branch1Label->getDataLabelFormat()->getTextFormat()->getPortionFormat()->getFillFormat()->getSolidFillColor()->setColor(java("java.awt.Color")->YELLOW);

todo:image_alt_text

设置数据点分支颜色

更改 “Steam 4” 分支的颜色：

  $pres = new Presentation();
  try {
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Sunburst, 100, 100, 450, 400);
    $dataPoints = $chart->getChartData()->getSeries()->get_Item(0)->getDataPoints();
    $stem4branch = $dataPoints->get_Item(9)->getDataPointLevels()->get_Item(1);
    $stem4branch->getFormat()->getFill()->setFillType(FillType::Solid);
    $stem4branch->getFormat()->getFill()->getSolidFillColor()->setColor(java("java.awt.Color")->RED);
    $pres->save("pres.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

todo:image_alt_text

常见问题

我可以更改 Sunburst/Treemap 中段的顺序（排序）吗？

不能。PowerPoint 会自动对段进行排序（通常按值降序，顺时针）。Aspose.Slides 也遵循此行为：无法直接更改顺序；只能通过预处理数据来实现。

演示文稿的主题如何影响段和标签的颜色？

除非显式设置填充/字体，否则图表颜色会继承演示文稿的 主题/调色板。为获得一致的效果，请在所需层级上锁定纯色填充和文本格式。

导出为 PDF/PNG 时会保留自定义分支颜色和标签设置吗？

会。导出演示文稿时，图表的设置（填充、标签）会在输出格式中保留，因为 Aspose.Slides 会按照图表的格式进行渲染。

我能计算标签/元素的实际坐标，以在图表上方放置自定义覆盖层吗？

可以。在图表布局验证完成后，元素（例如 DataLabel）的实际 x 和实际 y 坐标即可获取，这有助于精确定位覆盖层。

使用 PHP 在演示文稿中自定义饼图