Přizpůsobení chybových pruhů v prezentačních grafech pomocí PHP

Přehled

Tento článek vysvětluje, jak pracovat s chybovými pruhy v prezentačních grafech pomocí Aspose.Slides. Ukazuje, jak přidat chybové pruhy k sérii grafu, nakonfigurovat nastavení chybových pruhů X a Y a použít různé typy hodnot, jako jsou pevné, procentuální a vlastní hodnoty.

Také demonstruje, jak přiřadit vlastní hodnoty chybových pruhů jednotlivým datovým bodům v sérii pomocí odpovídající kolekce datových bodů. Navíc článek obsahuje stručné poznámky o tom, jak se chybové pruhy chovají během exportu, jejich kompatibilitě s značkami a popisky dat a kde najít související třídy a výčty v API referenci.

Přidání chybových pruhů

Aspose.Slides for PHP via Java poskytuje jednoduché API pro správu hodnot chybových pruhů. Ukázkový kód platí při použití vlastního typu hodnoty. Chcete‑li zadat hodnotu, použijte vlastnost ErrorBarCustomValues konkrétního datového bodu v kolekci datové body série:

1. Vytvořte instanci třídy Presentation.
2. Přidejte bublinový graf na požadovaný snímek.
3. Získejte první sérii grafu a nastavte formát chybového pruhu X.
4. Získejte první sérii grafu a nastavte formát chybového pruhu Y.
5. Nastavte hodnoty a formát pruhů.
6. Uložte upravenou prezentaci do souboru PPTX.

  # Vytvořte instanci třídy Presentation
  $pres = new Presentation();
  try {
    # Vytvoření bublinového grafu
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Bubble, 50, 50, 400, 300, true);
    # Přidání chybových pruhů a nastavení jejich formátu
    $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();
    # Uložení prezentace
    $pres->save("ErrorBars.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

Přidání vlastních hodnot chybových pruhů

Aspose.Slides for PHP via Java poskytuje jednoduché API pro správu vlastních hodnot chybových pruhů. Ukázkový kód platí, když metoda ErrorBarsFormat::getValueType vrátí Custom. Chcete‑li zadat hodnotu, použijte vlastnost ErrorBarCustomValues konkrétního datového bodu v kolekci datové body série:

1. Vytvořte instanci třídy Presentation.
2. Přidejte bublinový graf na požadovaný snímek.
3. Získejte první sérii grafu a nastavte formát chybového pruhu X.
4. Získejte první sérii grafu a nastavte formát chybového pruhu Y.
5. Získejte jednotlivé datové body série grafu a nastavte hodnoty chybových pruhů pro každý datový bod.
6. Nastavte hodnoty a formát pruhů.
7. Uložte upravenou prezentaci do souboru PPTX.

  # Vytvořte instanci třídy Presentation
  $pres = new Presentation();
  try {
    # Vytvoření bublinového grafu
    $chart = $pres->getSlides()->get_Item(0)->getShapes()->addChart(ChartType::Bubble, 50, 50, 400, 300, true);
    # Přidání vlastních chybových pruhů a nastavení jejich formátu
    $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);
    # Přístup k datovému bodu série grafu a nastavení hodnot chybových pruhů pro
    # jednotlivý bod
    $points = $series->getDataPoints();
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForXPlusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForXMinusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForYPlusValues(DataSourceType::DoubleLiterals);
    $points->getDataSourceTypeForErrorBarsCustomValues()->setDataSourceTypeForYMinusValues(DataSourceType::DoubleLiterals);
    # Nastavení chybových pruhů pro body série grafu
    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);
    }
    # Uložení prezentace
    $pres->save("ErrorBarsCustomValues.pptx", SaveFormat::Pptx);
  } finally {
    if (!java_is_null($pres)) {
      $pres->dispose();
    }
  }

FAQ

Co se stane s chybovými pruhy při exportu prezentace do PDF nebo obrázků?

Jsou vykresleny jako součást grafu a během konverze zachovány spolu se zbytkem formátování grafu, za předpokladu kompatibilní verze nebo rendereru.

Lze chybové pruhy kombinovat se značkami a popisky dat?

Ano. Chybové pruhy jsou samostatný prvek a jsou kompatibilní se značkami a popisky dat; pokud se prvky překrývají, může být nutné upravit formátování.

Kde najdu seznam vlastností a tříd pro práci s chybovými pruhy v API?

V API referenci: třída ErrorBarsFormat a související třídy ErrorBarType a ErrorBarValueType.