使用 PHP 在演示文稿中自定义图表坐标轴

本页内容简介

了解如何使用 Aspose.Slides for PHP via Java 在 PowerPoint 演示文稿中自定义图表坐标轴，以用于报告和可视化。

概述

本文说明了如何使用 Aspose.Slides for PHP via Java 自定义图表坐标轴。它涵盖了计算坐标轴值、交换图表行列、坐标轴可见性、类别标签和刻度间隔、日期类别和格式、标题旋转、坐标轴定位、显示单位以及对数缩放。

获取图表垂直坐标轴的最大值

创建一个Presentation，并添加一个带有默认数据的面积图。在读取计算坐标轴值之前调用validateChartLayout，以确保图表布局是最新的。

读取getActualMaxValue和getActualMinValue获取坐标轴限制，使用getActualMajorUnit和getActualMinorUnit获取刻度间隔。getActualMajorUnitScale和getActualMinorUnitScale提供时间单位比例，适用于日期坐标轴。示例将这些值存储在本地变量中并保存图表。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Area, 100, 100, 500, 350);
    $chart->validateChartLayout();

    $maxValue = $chart->getAxes()->getVerticalAxis()->getActualMaxValue();
    $minValue = $chart->getAxes()->getVerticalAxis()->getActualMinValue();

    $majorUnit = $chart->getAxes()->getVerticalAxis()->getActualMajorUnit();
    $minorUnit = $chart->getAxes()->getVerticalAxis()->getActualMinorUnit();

    $majorUnitScale = $chart->getAxes()->getVerticalAxis()->getActualMajorUnitScale();
    $minorUnitScale = $chart->getAxes()->getVerticalAxis()->getActualMinorUnitScale();

    $presentation->save("AxisValues_out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

交换坐标轴之间的数据

使用switchRowColumn交换图表数据中系列和类别的角色。每个原来的类别变为系列，每个原来的系列变为类别。这会改变数据的分组方式；并不交换水平和垂直坐标轴。示例使用setRange将默认数据绑定到Sheet1!A1:D5（包括标题行和类别列），然后再交换行列。它保存了一个包含四个系列和三个类别的图表。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 100, 100, 400, 300);
    $chart->getChartData()->setRange("Sheet1!A1:D5");
    $chart->getChartData()->switchRowColumn();

    $presentation->save("SwitchChartRowColumns_out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

反转坐标轴的绘制顺序

使用setPlotOrderReversed反转类别或数值坐标轴。例如，水平条形图可以按工作表中的相同顺序从上到下显示项目阶段：Planning、Development、Testing。反转坐标轴会改变绘制方向；不会对工作簿数据进行排序或重新排列。相比之下，switchRowColumn交换系列和类别的角色。

下面的示例创建了一个包含三个阶段和一个系列的水平条形图。它保存了一个包含三张幻灯片的演示文稿：正常顺序、类别反转和数值反转。每个副本使用相同的数据集，且每个副本仅反转一个坐标轴。

use aspose\slides\ChartType;
use aspose\slides\CrossesType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredBar, 50, 40, 620, 320);
    $chart->setLegend(false);

    $chart->getChartData()->getCategories()->clear();
    $chart->getChartData()->getSeries()->clear();

    $workbook = $chart->getChartData()->getChartDataWorkbook();
    $workbook->clear(0);

    $series = $chart->getChartData()->getSeries()->add(ChartType::ClusteredBar);
    $stages = ["Planning", "Development", "Testing"];
    $values = [10, 30, 20];
    for ($i = 0; $i < count($stages); $i++) {
        $categoryCell = $workbook->getCell(0, $i + 1, 0, $stages[$i]);
        $chart->getChartData()->getCategories()->add($categoryCell);
        $valueCell = $workbook->getCell(0, $i + 1, 1, $values[$i]);
        $series->getDataPoints()->addDataPointForBarSeries($valueCell);
    }

    // 第2张幻灯片：在顶部显示第一个类别。
    $categorySlide = $presentation->getSlides()->addClone($slide);
    $categoryChart = $categorySlide->getShapes()->get_Item(0);
    $categoryChart->getAxes()->getVerticalAxis()->setPlotOrderReversed(true);
    // 保持水平数值坐标轴位于底部。
    $categoryChart->getAxes()->getVerticalAxis()->setCrossType(CrossesType::Maximum);

    // 第3张幻灯片：仅反转水平数值刻度。
    $valueSlide = $presentation->getSlides()->addClone($slide);
    $valueChart = $valueSlide->getShapes()->get_Item(0);
    $valueChart->getAxes()->getHorizontalAxis()->setPlotOrderReversed(true);

    $presentation->save("ReversedAxes.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

反转坐标轴还可以将垂直坐标轴移动到绘图区域的另一侧。setCrossType控制另一坐标轴在被配置坐标轴的何处交叉。在第 2 张幻灯片中，对反转的类别坐标轴使用CrossesType::Maximum保持水平数值坐标轴位于底部。若需特定交叉点，请使用setCrossAt。在改变方向时请检查交叉设置，尤其是图表已有自定义交叉点的情况。调用setPlotOrderReversed并传入false可恢复正常绘制方向；交叉设置是独立的。

正常顺序（第 1 张幻灯片）	类别反转（第 2 张幻灯片）	数值反转（第 3 张幻灯片）
类别从下到上排列；数值从左到右递增。	计划、开发和测试从上到下排列。数值和工作表行顺序保持不变。	类别保持正常顺序；数值从右到左递增。类别坐标轴在右侧零处交叉。

为折线图禁用垂直坐标轴

对垂直坐标轴调用setVisible并传入false以隐藏它。示例创建了一个默认数据的折线图并保存了隐藏垂直坐标轴的文件。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Line, 100, 100, 400, 300);
    $chart->getAxes()->getVerticalAxis()->setVisible(false);

    $presentation->save("HiddenVerticalAxis.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

为折线图禁用水平坐标轴

对水平坐标轴调用setVisible并传入false以隐藏它。示例创建了一个默认数据的折线图并保存了隐藏水平坐标轴的文件。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Line, 100, 100, 400, 300);
    $chart->getAxes()->getHorizontalAxis()->setVisible(false);

    $presentation->save("HiddenHorizontalAxis.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

更改类别坐标轴

使用setCategoryAxisType选择日期或文本类别坐标轴。该示例需要ExistingChart.pptx，其中图表位于第一张幻灯片的第一个形状，且类别单元格包含数值型 Excel 日期。它将水平坐标轴更改为日期坐标轴。将setAutomaticMajorUnit设为false，setMajorUnit设为1，并将setMajorUnitScale设为TimeUnitType::Months，即可使主刻度以一个月为间隔。

use aspose\slides\CategoryAxisType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TimeUnitType;

$presentation = new Presentation("ExistingChart.pptx");
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->get_Item(0);
    $chart->getAxes()->getHorizontalAxis()->setCategoryAxisType(CategoryAxisType::Date);
    $chart->getAxes()->getHorizontalAxis()->setAutomaticMajorUnit(false);
    $chart->getAxes()->getHorizontalAxis()->setMajorUnit(1);
    $chart->getAxes()->getHorizontalAxis()->setMajorUnitScale(TimeUnitType::Months);

    $presentation->save("ChangeChartCategoryAxis_out.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

控制类别坐标轴标签间隔

当图表包含大量类别时，可在不删除类别或数据点的前提下减少可见坐标轴标签的数量。调用setAutomaticTickLabelSpacing并传入false，随后将期望的类别间隔传递给setTickLabelSpacing。对于正常顺序的文本类别，计数从第一个类别开始：

间隔	示例中显示的标签
1	类别 1, 类别 2, 类别 3, … 类别 24
2	类别 1, 类别 3, 类别 5, … 类别 23
3	类别 1, 类别 4, 类别 7, … 类别 22

3 的间隔会每隔两个标签显示一个标签，即每第三个标签显示一次，隐藏了两标签。它不会删除相应的列。自动间隔会根据可用空间选择间隔；并不一定显示所有标签。

刻度线有独立的控制方式。调用setAutomaticTickMarksSpacing并传入false，再使用setTickMarksSpacing设置其间隔。例如，1 会在每个类别间隔保留刻度线，而标签仅每第三个类别显示一次。使用setMajorTickMark并设置可见样式，以便看到效果。再次将任一自动间隔设置器设为true，图表会重新选择该间隔。

下面的自包含示例创建 24 个类别和一个系列，然后在 CategoryAxisIntervals.pptx 中保存三张幻灯片：自动间隔、手动标签间隔（刻度线独立）以及恢复自动间隔。两个副本保留原始图表数据。无需输入演示文稿。水平标签文本使密度差异一目了然。

use aspose\slides\CategoryAxisType;
use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;
use aspose\slides\TickMarkType;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 30, 40, 660, 320);

    $chart->setLegend(false);
    $chart->getChartData()->getCategories()->clear();
    $chart->getChartData()->getSeries()->clear();

    $workbook = $chart->getChartData()->getChartDataWorkbook();
    $workbook->clear(0);

    $series = $chart->getChartData()->getSeries()->add(ChartType::ClusteredColumn);
    for ($i = 0; $i < 24; $i++) {
        $categoryCell = $workbook->getCell(0, $i + 1, 0, "Category " . ($i + 1));
        $chart->getChartData()->getCategories()->add($categoryCell);
        $valueCell = $workbook->getCell(0, $i + 1, 1, 10 + $i % 6 * 5);
        $series->getDataPoints()->addDataPointForBarSeries($valueCell);
    }

    $axis = $chart->getAxes()->getHorizontalAxis();
    $axis->setCategoryAxisType(CategoryAxisType::Text);
    $axis->getTextFormat()->getTextBlockFormat()->setRotationAngle(0);
    $axis->getTextFormat()->getPortionFormat()->setFontHeight(12);
    $axis->setMajorTickMark(TickMarkType::Outside);
    $axis->setAutomaticTickLabelSpacing(true);
    $axis->setAutomaticTickMarksSpacing(true);

    // 第2张幻灯片：显示每第三个标签，但保持每个类别都有刻度线。
    $manualSlide = $presentation->getSlides()->addClone($slide);
    $manualChart = $manualSlide->getShapes()->get_Item(0);
    $manualAxis = $manualChart->getAxes()->getHorizontalAxis();
    $manualAxis->setAutomaticTickLabelSpacing(false);
    $manualAxis->setTickLabelSpacing(3);
    $manualAxis->setAutomaticTickMarksSpacing(false);
    $manualAxis->setTickMarksSpacing(1);

    // 第3张幻灯片：让图表再次自行选择两个间隔。
    $restoredSlide = $presentation->getSlides()->addClone($manualSlide);
    $restoredChart = $restoredSlide->getShapes()->get_Item(0);
    $restoredChart->getAxes()->getHorizontalAxis()->setAutomaticTickLabelSpacing(true);
    $restoredChart->getAxes()->getHorizontalAxis()->setAutomaticTickMarksSpacing(true);

    $presentation->save("CategoryAxisIntervals.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

自动间隔（第 1 张幻灯片）： 在此渲染中，每隔一个类别标签显示一次，并换行为两行。自动结果可能随图表大小、字体和渲染器而变化。

手动间隔（第 2 张幻灯片）： 每第三个标签显示在一行上，而刻度线仍保留在每个类别间隔。所有 24 列（包括没有标签的列）仍保持可见且数值相同。第 3 张幻灯片恢复了上述自动外观。

选择正确的坐标轴和间隔

将此类别计数间隔用于文本类别坐标轴，例如柱形图、折线图、面积图或条形图的类别坐标轴。在柱形图中，它是水平坐标轴；在水平条形图中，类别坐标轴是垂直的，因此应将这些设置应用于getVerticalAxis返回的坐标轴。刻度间隔同样适用于拥有系列坐标轴的图表。

不要使用类别标签间隔来设置数值坐标轴的数值刻度。在数值坐标轴上，setMajorUnit指定数值差异，例如，主单位为 10 时，当坐标轴从零开始时会在 0、10、20 等位置生成刻度。类别标签间隔为 3 则仅计数类别位置，忽略其数值。散点图和气泡图使用数值坐标轴而非文本类别坐标轴。对于日期坐标轴，请参照更改类别坐标轴中描述的基于时间的主单位和比例。

设置类别坐标轴值的日期格式

示例用四个年度值替换默认图表数据。日期以 OLE Automation 序列号存储在第一个工作表（索引 0）中，计算方式为自 1899 年 12 月 30 日起的天数。使用setCategoryAxisType并传入CategoryAxisType::Date，调用setNumberFormatLinkedToSource并设为false，再将yyyy 传给setNumberFormat，即可让类别标签独立于单元格格式显示四位年份。

use aspose\slides\CategoryAxisType;
use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Line, 50, 50, 450, 300);

    $chart->getChartData()->getCategories()->clear();
    $chart->getChartData()->getSeries()->clear();

    $workbook = $chart->getChartData()->getChartDataWorkbook();
    $workbook->clear(0);

    $baseDate = gmmktime(0, 0, 0, 12, 30, 1899);

    $series = $chart->getChartData()->getSeries()->add(ChartType::Line);
    for ($i = 0; $i < 4; $i++) {
        $date = gmmktime(0, 0, 0, 1, 1, 2015 + $i);
        $serialDate = ($date - $baseDate) / 86400;
        $categoryCell = $workbook->getCell(0, $i + 1, 0, $serialDate);
        $chart->getChartData()->getCategories()->add($categoryCell);

        $valueCell = $workbook->getCell(0, $i + 1, 1, $i + 1);
        $series->getDataPoints()->addDataPointForLineSeries($valueCell);
    }

    $chart->getAxes()->getHorizontalAxis()->setCategoryAxisType(CategoryAxisType::Date);
    $chart->getAxes()->getHorizontalAxis()->setNumberFormatLinkedToSource(false);
    $chart->getAxes()->getHorizontalAxis()->setNumberFormat("yyyy");

    $presentation->save("DateAxisFormat.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

为图表坐标轴标题设置旋转角度

对垂直坐标轴调用setTitle并传入true，提供标题文本后使用setRotationAngle旋转标题。角度以度为单位；本示例保存了一个列图，其数值坐标轴标题旋转了 90 度。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 50, 50, 450, 300);
    $chart->getAxes()->getVerticalAxis()->setTitle(true);
    $chart->getAxes()->getVerticalAxis()->getTitle()->addTextFrameForOverriding("Value");
    $chart->getAxes()->getVerticalAxis()->getTitle()->getTextFormat()->getTextBlockFormat()->setRotationAngle(90);

    $presentation->save("RotatedAxisTitle.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

设置类别或数值坐标轴的位置

使用setAxisBetweenCategories控制数值坐标轴是穿过类别坐标轴之间还是在类别刻度线上。此设置适用于类别坐标轴。示例将其在列图的水平类别坐标轴上设为true并保存结果。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 50, 50, 450, 300);
    $chart->getAxes()->getHorizontalAxis()->setAxisBetweenCategories(true);

    $presentation->save("AxisBetweenCategories.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

为图表数值坐标轴设置显示单位

使用setDisplayUnit可以在不改变底层数据的情况下缩放数值坐标轴标签。将DisplayUnitType设为Millions后，60000000 将显示为 60。示例创建了一个列图并将其垂直坐标轴的显示单位设为百万。

use aspose\slides\ChartType;
use aspose\slides\DisplayUnitType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 50, 50, 450, 300);
    $chart->getAxes()->getVerticalAxis()->setDisplayUnit(DisplayUnitType::Millions);

    $presentation->save("Result.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

配置对数数值坐标轴

当正值跨越多个数量级时，对数数值坐标轴非常有用。例如，某服务在五个时期可能收到 10、100、1,000、10,000 和 100,000 次请求。在线性尺度下，较小的值会聚集在靠近零的位置。对数尺度使其相对增长更易比较：相等的距离代表相等的比例，而不是相等的差值。

对数数值坐标轴使用setLogarithmic并传入true，再用setLogBase选择基数。此操作仅改变现有值的显示方式；不会更改数据或添加对数趋势线。趋势线是对数据进行拟合的独立功能。

选择数值坐标轴和基数

对于折线图或柱形图，数值坐标轴由getVerticalAxis返回。对于水平条形图，数值坐标轴由getHorizontalAxis返回。散点图和气泡图有两个数值坐标轴，因此可为 X 值选择水平坐标轴，为 Y 值选择垂直坐标轴，或两者皆选。不要对类别坐标轴应用对数缩放。

默认的对数基数是 10。对于 PPTX 图表，基数可使用 2 到 1000（含）的整数，也支持 2.5 等小数。基数为 10 时，后续的 10、100、1,000、10,000 等幂次等距分布。

比较线性和对数缩放

下面的自包含示例在第一张幻灯片上创建了一个包含五个请求计数的折线图，然后克隆该幻灯片并在第二张上启用基数为 10 的对数数值坐标轴。两张幻灯片保留相同的数据。

use aspose\slides\ChartType;
use aspose\slides\Presentation;
use aspose\slides\SaveFormat;

$presentation = new Presentation();
try {
    $slide = $presentation->getSlides()->get_Item(0);

    $chart = $slide->getShapes()->addChart(ChartType::Line, 30, 40, 660, 200);

    $chart->setLegend(false);

    $chart->getChartData()->getCategories()->clear();
    $chart->getChartData()->getSeries()->clear();

    $workbook = $chart->getChartData()->getChartDataWorkbook();
    $workbook->clear(0);

    $series = $chart->getChartData()->getSeries()->add(ChartType::Line);
    $values = [10, 100, 1000, 10000, 100000];

    for ($i = 0; $i < count($values); $i++) {
        $categoryCell = $workbook->getCell(0, $i + 1, 0, "Period " . ($i + 1));
        $chart->getChartData()->getCategories()->add($categoryCell);

        $valueCell = $workbook->getCell(0, $i + 1, 1, $values[$i]);
        $series->getDataPoints()->addDataPointForLineSeries($valueCell);
    }

    // 保持第一张幻灯片为线性，仅更改副本的数值坐标轴比例。
    $logarithmicSlide = $presentation->getSlides()->addClone($slide);
    $logarithmicChart = $logarithmicSlide->getShapes()->get_Item(0);
    $valueAxis = $logarithmicChart->getAxes()->getVerticalAxis();
    $valueAxis->setLogarithmic(true);
    $valueAxis->setLogBase(10);

    $presentation->save("LogarithmicAxis.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}

线性尺度（第 1 张幻灯片）： 相等的垂直距离代表请求计数的相等差值。最大值主导图表，使得较小的值难以辨别。

对数尺度（第 2 张幻灯片）： 相等的垂直距离代表相等的比例。每个时期的请求量是前一个时期的十倍，因此在基数为 10 的尺度上点形成一条直线上升线。坐标轴标签仍显示原始请求计数。

处理零和负值

对数尺度只能显示严格正数。启用前请检查数据。如果零或负值有实际意义，请保持线性尺度或单独展示。如果在分析中排除这些值是合理的，请说明原因。不要悄悄将它们替换为小的正数，因为这会改变数据的含义。对数坐标轴的任何手动最小值或最大值也必须为正。

常见问题

如何设置一个坐标轴与另一个坐标轴交叉的数值（坐标轴交叉点）？

使用setCrossType选择交叉行为。若要指定数值型交叉点，请使用setCrossAt。这些设置可将坐标轴交叉移动到合适的基线。

如何相对于坐标轴定位刻度标签？

调用setTickLabelPosition并使用TickLabelPositionType：Low、High、NextTo 或 None。若要控制刻度线本身，请使用setMajorTickMark或setMinorTickMark；这些设置与标签定位是独立的。