使用 PHP 自訂簡報圖表中的誤差棒

概觀

本文說明如何使用 Aspose.Slides 在簡報圖表中使用誤差棒。它展示了如何將誤差棒新增至圖表系列、設定 X 與 Y 誤差棒，並套用固定值、百分比及自訂值等不同的值類型。

它也示範了如何使用相應的資料點集合，為系列中的各個資料點指定自訂誤差棒值。此外，本文還簡要說明了誤差棒在匯出時的行為、與標記和資料標籤的相容性，以及在何處可以找到相關的 API 參考類別與列舉。

新增誤差棒

Aspose.Slides for PHP via Java 提供了簡易的 API 來管理誤差棒值。當使用自訂值類型時，可套用範例程式碼。若要指定值，請使用系列中 資料點 集合內特定資料點的 ErrorBarCustomValues 屬性：

建立 Presentation 類別的實例。
在目標投影片上新增氣泡圖表。
取得第一個圖表系列，並設定誤差棒 X 格式。
取得第一個圖表系列，並設定誤差棒 Y 格式。
設定棒的數值與格式。
將修改後的簡報寫入 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 屬性：

建立 Presentation 類別的實例。
在目標投影片上新增氣泡圖表。
取得第一個圖表系列，並設定誤差棒 X 格式。
取得第一個圖表系列，並設定誤差棒 Y 格式。
存取圖表系列的個別資料點，並為每個資料點設定誤差棒值。
設定棒的數值與格式。
將修改後的簡報寫入 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();
    }
  }

常見問題

當將簡報匯出為 PDF 或影像時，誤差棒會發生什麼情形？

它們會作為圖表的一部分被繪製，並在轉換過程中與其他圖表格式一起保留，前提是使用相容的版本或渲染器。

誤差棒可以與標記和資料標籤結合使用嗎？

可以。誤差棒是獨立的元素，且與標記和資料標籤相容；若元素重疊，可能需要調整格式。

在 API 中，哪裡可以找到用於操作誤差棒的屬性與類別清單？

在 API 參考中：ErrorBarsFormat 類別以及相關的 ErrorBarType 和 ErrorBarValueType 類別。