Настройка линий ошибок в диаграммах презентаций с использованием PHP

Добавить линии ошибок

Aspose.Slides for PHP via Java предоставляет простой API для управления значениями линий ошибок. Пример кода применим при использовании пользовательского типа значения. Чтобы указать значение, используйте свойство ErrorBarCustomValues конкретной точки данных в коллекции data points серии:

1. Создайте экземпляр класса Presentation.
2. Добавьте пузырчатую диаграмму на нужный слайд.
3. Получите первый ряд диаграммы и задайте формат линии ошибки по оси X.
4. Получите первый ряд диаграммы и задайте формат линии ошибки по оси Y.
5. Установите значения линий и их формат.
6. Запишите изменённую презентацию в файл PPTX.

  # Создать экземпляр класса Presentation
  $pres = new Presentation();
  try {
    # Создание пузырчатой диаграммы
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Bubble, 50, 50, 400, 300, true);
    # Добавление линий ошибок и настройка их формата
    $errBarX = $chart->getChartData()->getSeries()->get_Item(0)->getErrorBarsXFormat();
    $errBarY = $chart->getChartData()->getSeries()->get_Item(0)->getErrorBarsYFormat();
    $errBarX->isVisible();
    $errBarY->isVisible();
    $errBarX->setValueType(ErrorBarValueType::Fixed);
    $errBarX->setValue(0.1);
    $errBarY->setValueType(ErrorBarValueType::Percentage);
    $errBarY->setValue(5);
    $errBarX->setType(ErrorBarType::Plus);
    $errBarY->getFormat()->getLine()->setWidth(2.0);
    $errBarX->hasEndCap();
    # Сохранение презентации
    $pres->save("ErrorBars.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Добавить пользовательские значения линий ошибок

Aspose.Slides for PHP via Java предоставляет простой API для управления пользовательскими значениями линий ошибок. Пример кода применим, когда метод ErrorBarsFormat::getValueType возвращает Custom. Чтобы указать значение, используйте свойство ErrorBarCustomValues конкретной точки данных в коллекции data points серии:

1. Создайте экземпляр класса Presentation.
2. Добавьте пузырчатую диаграмму на нужный слайд.
3. Получите первый ряд диаграммы и задайте формат линии ошибки по оси X.
4. Получите первый ряд диаграммы и задайте формат линии ошибки по оси Y.
5. Получите отдельные точки данных ряда диаграммы и задайте значения линии ошибки для каждой точки данных.
6. Установите значения линий и их формат.
7. Запишите изменённую презентацию в файл PPTX.

  # Создать экземпляр класса Presentation
  $pres = new Presentation();
  try {
    # Создание пузырчатой диаграммы
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Bubble, 50, 50, 400, 300, true);
    # Добавление пользовательских линий ошибок и настройка их формата
    $series = $chart->getChartData()->getSeries()->get_Item(0);
    $errBarX = $series->getErrorBarsXFormat();
    $errBarY = $series->getErrorBarsYFormat();
    $errBarX->isVisible();
    $errBarY->isVisible();
    $errBarX->setValueType(ErrorBarValueType::Custom);
    $errBarY->setValueType(ErrorBarValueType::Custom);
    # Доступ к точке данных ряда диаграммы и установка значений линий ошибок для
    # отдельной точки
    $points = $series->getDataPoints();
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForXPlusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForXMinusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForYPlusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForYMinusValues(DataSourceType::DoubleLiterals);
    # Установка линий ошибок для точек ряда диаграммы
    for($i = 0; $i < java_values($points->size()) ; $i++) {
      $points->get_Item($i)->getErrorBarsCustomValues()->getXMinus()->setAsLiteralDouble($i + 1);
      $points->get_Item($i)->getErrorBarsCustomValues()->getXPlus()->setAsLiteralDouble($i + 1);
      $points->get_Item($i)->getErrorBarsCustomValues()->getYMinus()->setAsLiteralDouble($i + 1);
      $points->get_Item($i)->getErrorBarsCustomValues()->getYPlus()->setAsLiteralDouble($i + 1);
    }
    # Сохранение презентации
    $pres->save("ErrorBarsCustomValues.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Что происходит с линиями ошибок при экспорте презентации в PDF или изображения?

Они отображаются как часть диаграммы и сохраняются при конвертации вместе с остальным форматированием диаграммы, при условии совместимой версии или рендерера.

Можно ли комбинировать линии ошибок с маркерами и подписями данных?

Да. Линии ошибок являются отдельным элементом и совместимы с маркерами и подписями данных; если элементы перекрываются, может потребоваться скорректировать форматирование.

Где можно найти список свойств и классов для работы с линиями ошибок в API?

В справочнике API: класс ErrorBarsFormat и связанные классы ErrorBarType и ErrorBarValueType.