Diagram adatsorok kezelése bemutatókban PHP-ben

Áttekintés

A diagram tárolhatja a megjelenített értékeket a munkafüzet celláiban vagy közvetlenül numerikus literálokként. A ChartSeries egy kapcsolódó értékkészletet képvisel, és minden ChartDataPoint egy pontot jelent ebben a sorozatban. A ChartCategory objektumok a sorozatok által megosztott címkéket vagy csoportosítási értékeket biztosítják. Az alapértelmezett adatokkal létrehozott diagramokban a sorozatnevek, kategóriák és pontértékek a diagram munkafüzetéből származó ChartDataCell objektumokat használják.

A tipikus kategória diagram esetén az alapértelmezett munkafüzet az 0. sort a sorozatneveknek, a 0. oszlopot a kategórianévnek, a maradék cellákat pedig a sorozatértékeknek használja. A ChartDataWorkbook::getCell metódusnak átadott munkalap-, sor- és oszlopszámok nullával kezdődnek. Ez a felépítés hasznos, ha alapértelmezett adatokkal hoz létre diagramot, de ne feltételezze, hogy minden létező diagram ezt használja. Betöltött bemutató esetén ellenőrizze a sorozatok, kategóriák és adatpontok által hivatkozott cellákat, mielőtt a munkafüzet értékeit módosítaná.

A diagrambeállítások három különböző hatókörrel rendelkeznek:

  • Sorozatszintű beállítások, például a ChartSeries::getFormat adja meg az alapértelmezett megjelenést egy sorozat összes pontjához.
  • Adatpont szintű beállítások, például a ChartDataPoint::getFormat felülírja a sorozat megjelenését egyetlen pontra.
  • Csoport beállítások olyan kompatibilis sorozatokra vonatkoznak, amelyek ugyanahhoz a ChartSeriesGroup tartoznak. A csoportot a ChartSeries::getParentSeriesGroup metódussal érheti el, ha például az átfedés vagy a réstávolság beállítására van szüksége.

Ha nincs kifejezetten beállítva pont- vagy sorozatkitöltés, a diagram stílusa és témája határozza meg az automatikus megjelenést. Ha mind a sorozat, mind a pont formázása jelen van, a pont formázása felülbírálja a sorozatét az adott pont esetén.

chart-series-powerpoint

Csoportos hengerdiagram esetén tekintse meg, hogy a changing the 3D series type or bar shape hogyan befolyásolja az első sorozatot.

Sorozatértékek beállítása numerikus literálokkal

Használjon numerikus literálokat, amikor a sorozatértékek az alkalmazás adatából vagy számításából származnak, és nem szükséges munkalap‑cellahivatkozás. Hívja a setDataSourceTypeForValues metódust a DataSourceType::DoubleLiterals értékével, mielőtt minden pont getValue eredményét a setAsLiteralDouble segítségével állítaná be.

A gyűjtemény beállítása a sorozat összes pontértékének forrástípusát szabályozza. Az egyes pontértékek getDataSourceType metódusa jelentést készít a kiválasztott típusról; ezt a gyűjtemény beállításával módosíthatja. Worksheet esetén a getAsCell hívható a hivatkozott cella eléréséhez. DoubleLiterals esetén a getAsLiteralDouble vagy a setAsLiteralDouble használható a szám közvetlen olvasásához vagy írásához.

Az alábbi példa egy oszlopdiagramot hoz létre alapértelmezett sorozatokkal és kategóriákkal, majd a meglévő első sorozat pontjainak értékeit 10, 20 és így tovább számított értékekkel tölti fel. A bemutatót elmenti, újra megnyitja, és kiírja a tárolt értékeket.

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

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 300);
    $series = $chart->getChartData()->getSeries()->get_Item(0);

    $series->getDataPoints()->setDataSourceTypeForValues(DataSourceType::DoubleLiterals);
    $pointCount = java_values($series->getDataPoints()->size());
    for ($i = 0; $i < $pointCount; $i++) {
        $series->getDataPoints()->get_Item($i)->getValue()->setAsLiteralDouble(($i + 1) * 10);
    }

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

$reopenedPresentation = new Presentation("numeric_literals.pptx");
try {
    $reopenedSlide = $reopenedPresentation->getSlides()->get_Item(0);
    $reopenedChart = $reopenedSlide->getShapes()->get_Item(0);
    $reopenedSeries = $reopenedChart->getChartData()->getSeries()->get_Item(0);
    $pointCount = java_values($reopenedSeries->getDataPoints()->size());
    for ($i = 0; $i < $pointCount; $i++) {
        $point = $reopenedSeries->getDataPoints()->get_Item($i);
        echo java_values($point->getValue()->getAsLiteralDouble()), PHP_EOL;
    }
} finally {
    $reopenedPresentation->dispose();
}

A pontérték forrástípusa elkülönül a ChartData::getDataSourceType beállítástól, amely a diagram belső vagy külső munkafüzet‑konfigurációját jelöli. A numerikus literálok használata önmagában nem távolítja el a beágyazott munkafüzetet. Ebben a példában a munkafüzet továbbra is rendelkezésre áll a kategóriacímkékhez, sorozatnevekhez és a többi sorozathoz. Lásd a Chart Workbook részt a munkafüzet‑kezeléshez.

Szórt és buborék diagramok esetén használja a setDataSourceTypeForXValues és a setDataSourceTypeForYValues metódusokat a getXValue és a getYValue forrásainak kiválasztásához. A buborék diagramok a setDataSourceTypeForBubbleSizes metódust is használják a getBubbleSize esetén. Minden alkalmazandó forrást állítson DoubleLiterals‑re, mielőtt a setAsLiteralDouble metódussal számokat rendelnél hozzá.

Diagram sorozat átfedés beállítása

A ChartSeries::getOverlap megadja, hogy egy 2D diagramban a sávok vagy oszlopok mennyire átfedik egymást, -100 és 100 százalék között. Ez a szülő sorozatcsoport beállításának csak olvasható leképezése. A ChartSeriesGroup::setOverlap segítségével frissítheti a csoport minden kompatibilis sorozatát. Ez a lehetőség azokban a diagramtípusokban érvényes, amelyek csoportos sávokat vagy oszlopokat jelenítenek meg; a kombinációs diagramokban lévő egyéb sorozatcsoportokra nincs hatása.

Az alábbi példa a csoport átfedését állítja be, amely az első sorozatot tartalmazza:

$firstSlideIndex = 0;
$firstSeriesIndex = 0;
$overlapPercent = 30;

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

    // Az új diagram mintasorozatokat, kategóriákat és értékeket tartalmaz.
    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $series = $chart->getChartData()->getSeries()->get_Item($firstSeriesIndex);
    $series->getParentSeriesGroup()->setOverlap($overlapPercent);

    $presentation->save("series_overlap.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Az eredmény:

The series overlap

Sorozat kitöltőszín módosítása

Használja a ChartSeries::getFormat metódust egy teljes sorozat alapértelmezett kitöltésének beállításához. Ha egy pont már rendelkezik kifejezett kitöltéssel, annak a ChartDataPoint::getFormat beállítása felülírja a sorozat kitöltését az adott pontnál.

Az alábbi példa egy kék szilárd kitöltést alkalmaz az első sorozatra:

$firstSlideIndex = 0;
$firstSeriesIndex = 0;
$blueColor = java("java.awt.Color")->BLUE;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $series = $chart->getChartData()->getSeries()->get_Item($firstSeriesIndex);
    $series->getFormat()->getFill()->setFillType(FillType::Solid);
    $series->getFormat()->getFill()->getSolidFillColor()->setColor($blueColor);

    $presentation->save("series_color.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Az eredmény:

The color of the series

Sorozat név módosítása

A sorozat neve a diagram adatmunkafüzetében tárolódik, és általában a jelmagyarázatban jelenik meg. Egy csoportos oszlopdiagram alapértelmezett munkafüzetében a B1 cella (0‑s sor, 1‑s oszlop) tartalmazza az első sorozat nevét. Az alábbi példában a változónevek a struktúrát explicit módon tükrözik:

$firstSlideIndex = 0;
$worksheetIndex = 0;
$seriesNameRowIndex = 0;
$firstSeriesColumnIndex = 1;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $workbook = $chart->getChartData()->getChartDataWorkbook();
    $seriesNameCell = $workbook->getCell($worksheetIndex, $seriesNameRowIndex, $firstSeriesColumnIndex);
    $seriesNameCell->setValue("Revenue");

    $presentation->save("series_name.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

A ChartSeries::getName által már hivatkozott cellát is frissítheti. Ez a megközelítés elkerüli a meglévő diagram sor és oszlop konkrét pozíciójára való támaszkodást:

$firstSlideIndex = 0;
$firstSeriesIndex = 0;
$firstNameCellIndex = 0;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $series = $chart->getChartData()->getSeries()->get_Item($firstSeriesIndex);
    $seriesNameCell = $series->getName()->getAsCells()->get_Item($firstNameCellIndex);
    $seriesNameCell->setValue("Revenue");

    $presentation->save("series_name.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Az eredmény:

The series name

Sorozat létrehozása több cellából álló névvel

Kompozit sorozatnév akkor hasznos, ha egy terméknév és egy jelentési időszak külön munkafüzet‑cellákban van tárolva. Például a Product A értéket a B1‑ben és a 2026 értéket a C1‑ben egyetlen sorozatnévvé kombinálhatja, miközben mindkét rész hivatkozik a forráscellákra.

Használja a ChartDataWorkbook::getCellCollection metódust a névtartomány lekéréséhez, majd adja át ezt a gyűjteményt a ChartSeriesCollection::add metódusnak. A skipHiddenCells argumentum határozza meg, hogy a rejtett cellák szerepeljenek‑e: true kizárja őket, false pedig belefoglalja. Ebben a példában false‑t használunk, hogy a névtartomány minden celláját felvegyük.

Az alábbi példa egy bemutatót hoz létre egy sorozattal és két adatponttal. A B1:C1 cellák csak a sorozat nevét biztosítják; az A2:A3 a kategóriacímkéket, a B2:B3 pedig a numerikus értékeket.

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, 620, 180);

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

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

    // Ez a két cella biztosítja a sorozat nevét.
    $workbook->getCell(0, 0, 1, "Product A");
    $workbook->getCell(0, 0, 2, "2026");
    $nameCells = $workbook->getCellCollection('Sheet1!$B$1:$C$1', false);
    $series = $chart->getChartData()->getSeries()->add($nameCells, ChartType::ClusteredColumn);

    // Külön cellák biztosítják a kategóriákat és a numerikus adatpontokat.
    $northCategory = $workbook->getCell(0, 1, 0, "North");
    $southCategory = $workbook->getCell(0, 2, 0, "South");
    $chart->getChartData()->getCategories()->add($northCategory);
    $chart->getChartData()->getCategories()->add($southCategory);
    $northValue = $workbook->getCell(0, 1, 1, 120);
    $southValue = $workbook->getCell(0, 2, 1, 150);
    $series->getDataPoints()->addDataPointForBarSeries($northValue);
    $series->getDataPoints()->addDataPointForBarSeries($southValue);

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

Az eredményül kapott sorozatnév Product A 2026, egy szóközzel a két cellaérték között. A jelmagyarázat ezt egy bejegyzésként jeleníti meg mindkét oszlopra. Az alábbi kép mutatja az eredményt:

Column chart with North and South values and the composite series name Product A 2026 in the legend

Automatikus sorozat kitöltőszín lekérése

A ChartSeries::getAutomaticSeriesColor visszaadja a sorozatindex és a diagram stílusa alapján számított színt. Ez a szín akkor használatos, amikor a sorozat kitöltése nincs kifejezetten definiálva. A metódus csak kiolvassa a számított színt; nem állít be új kitöltést.

Az alábbi példa kiírja minden alapértelmezett sorozat automatikus színét:

$firstSlideIndex = 0;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $seriesCount = java_values($chart->getChartData()->getSeries()->size());
    for ($seriesIndex = 0; $seriesIndex < $seriesCount; $seriesIndex++) {
        $series = $chart->getChartData()->getSeries()->get_Item($seriesIndex);
        $automaticColor = $series->getAutomaticSeriesColor();
        $red = java_values($automaticColor->getRed());
        $green = java_values($automaticColor->getGreen());
        $blue = java_values($automaticColor->getBlue());
        echo "Series " . $seriesIndex . ": java.awt.Color[r=" . $red . ",g=" . $green . ",b=" . $blue . "]" . PHP_EOL;
    }
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Példa kimenet az alapértelmezett diagram stílusra:

Series 0: java.awt.Color[r=79,g=129,b=189]
Series 1: java.awt.Color[r=192,g=80,b=77]
Series 2: java.awt.Color[r=155,g=187,b=89]

A pontos színek a diagram stílusától és témájától függnek.

Inverz kitöltőszín beállítása egy diagram sorozathoz

Sáv, oszlop és buborék sorozatok esetén a ChartSeries::setInvertIfNegative segítségével megjeleníthető a negatív értékek eltérő kitöltéssel. Állítsa be a szabályos sorozat kitöltését szilárd színre, engedélyezze az inverziót, és adja meg a negatív értékek színét a ChartSeries::getInvertedSolidFillColor segítségével. A negatív számok a munkafüzetben változatlanok maradnak; csak a megjelenítési színük változik.

Az alábbi példa egy sorozattal helyettesíti az alapértelmezett diagram adatot. A munkalap 0‑s sora a sorozat nevét, a 0‑s oszlopa a kategória neveket, az 1‑s oszlopa pedig az értékeket tartalmazza:

$firstSlideIndex = 0;
$worksheetIndex = 0;
$headerRowIndex = 0;
$categoryColumnIndex = 0;
$firstSeriesColumnIndex = 1;
$firstDataRowIndex = 1;

$categoryNames = ["Category 1", "Category 2", "Category 3"];
$seriesValues = [-20, 50, -30];
$redColor = java("java.awt.Color")->RED;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);
    $chartData = $chart->getChartData();
    $workbook = $chartData->getChartDataWorkbook();

    $chartData->getSeries()->clear();
    $chartData->getCategories()->clear();

    $seriesNameCell = $workbook->getCell($worksheetIndex, $headerRowIndex, $firstSeriesColumnIndex, "Series 1");
    $chartType = $chart->getType();
    $series = $chartData->getSeries()->add($seriesNameCell, $chartType);

    $categoryCount = count($categoryNames);
    for ($categoryIndex = 0; $categoryIndex < $categoryCount; $categoryIndex++) {
        $dataRowIndex = $firstDataRowIndex + $categoryIndex;
        $categoryName = $categoryNames[$categoryIndex];
        $seriesValue = $seriesValues[$categoryIndex];

        $categoryCell = $workbook->getCell($worksheetIndex, $dataRowIndex, $categoryColumnIndex, $categoryName);
        $chartData->getCategories()->add($categoryCell);

        $valueCell = $workbook->getCell($worksheetIndex, $dataRowIndex, $firstSeriesColumnIndex, $seriesValue);
        $series->getDataPoints()->addDataPointForBarSeries($valueCell);
    }

    $automaticSeriesColor = $series->getAutomaticSeriesColor();
    $series->getFormat()->getFill()->setFillType(FillType::Solid);
    $series->getFormat()->getFill()->getSolidFillColor()->setColor($automaticSeriesColor);
    $series->setInvertIfNegative(true);
    $series->getInvertedSolidFillColor()->setColor($redColor);

    $presentation->save("inverted_solid_fill_color.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Az eredmény:

The inverted solid fill color

Inverziót egy ponton is engedélyezhet a ChartDataPoint::setInvertIfNegative segítségével. Az alábbi példában a sorozatra vonatkozó inverzió ki van kapcsolva, csak a kiválasztott ponton be van kapcsolva. A pontnak negatív értéket is adunk, hogy a hatás látható legyen:

$firstSlideIndex = 0;
$firstSeriesIndex = 0;
$targetDataPointIndex = 2;
$negativeValue = -30;
$redColor = java("java.awt.Color")->RED;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $series = $chart->getChartData()->getSeries()->get_Item($firstSeriesIndex);
    $automaticSeriesColor = $series->getAutomaticSeriesColor();
    $series->getFormat()->getFill()->setFillType(FillType::Solid);
    $series->getFormat()->getFill()->getSolidFillColor()->setColor($automaticSeriesColor);
    $series->getInvertedSolidFillColor()->setColor($redColor);
    $series->setInvertIfNegative(false);

    $dataPoint = $series->getDataPoints()->get_Item($targetDataPointIndex);
    $dataPoint->getValue()->getAsCell()->setValue($negativeValue);
    $dataPoint->setInvertIfNegative(true);

    $presentation->save("data_point_invert_color_if_negative.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Egy adott adatpont értékének törlése

Egy pont üresen hagyásához a többi pont eltávolítása nélkül, állítsa a mögöttes munkafüzet‑cellát null‑ra. Oszlopdiagram esetén a megjelenített érték a ChartDataPoint::getValue segítségével érhető el. Az adatpont a kategóriahelyen marad, de a diagram a értékét üresnek tekinti a diagram üres‑érték beállításai szerint.

Az alábbi példa csak a második pontot törli az első sorozatban:

$firstSlideIndex = 0;
$firstSeriesIndex = 0;
$targetDataPointIndex = 1;

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

    $chart = $slide->getShapes()->addChart(ChartType::ClusteredColumn, 20, 20, 500, 200);

    $series = $chart->getChartData()->getSeries()->get_Item($firstSeriesIndex);
    $dataPoint = $series->getDataPoints()->get_Item($targetDataPointIndex);
    $dataPoint->getValue()->getAsCell()->setValue(null);

    $presentation->save("clear_data_point_value.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Szórt diagramok külön X és Y cellákat használnak, a buborék diagramok továbbá egy méretcellát is. Csak azt a cellát törölje, amely a törlendő értéket reprezentálja. Ne hívja a ChartDataPointCollection::clear metódust, ha a többi pontot meg szeretné tartani, mert ez a metódus az összes adatpontot eltávolítja a sorozatból.

Üres cellák megjelenésének szabályozása

A rejtett, értékkel rendelkező cellák külön esetet képeznek az üres cellákkal szemben. A rejtett munkalap‑sorok és -oszlopok adatainak fel‑ vagy le­vonásához lásd a Include Data from Hidden Rows and Columns oldalt.

Egy üres munkafüzet‑cellá a hiányzó adatot jelzi; egy 0‑t tartalmazó cella ismert numerikus értéket jelent. A ChartDataCell::setValue metódussal null‑t adjon meg, hogy a cella üres legyen. A numerikus nulla minden esetben nulla marad, függetlenül az üres‑cellák beállításától.

A Chart::setDisplayBlanksAs metódussal választhatja ki, hogy a diagram hogyan jelenítse meg az üres cellákat. Ez a beállítás a teljes diagramra vonatkozik, és megváltoztatja, hogyan vannak ábrázolva a hiányzó értékek, anélkül, hogy a munkafüzet‑cellát nullával vagy interpolált értékkel töltené fel.

Az alábbi, önálló példában egy vonaldiagramot hoz létre egy sorozattal, a 3. nap értékét törli, majd minden mód szerint menti a diagramot. Bemeneti fájl nem szükséges. A ChartDataWorkbook a 0‑s munkalapot, az 0‑s oszlopot a kategóriacímkéknek, az 1‑s oszlopot az értékeknek használja; a 0‑s sor a sorozat nevét tartalmazza. A végső adatsor 10, 20, empty, 30, 40.

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

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

    $chart = $slide->getShapes()->addChart(ChartType::LineWithMarkers, 40, 40, 640, 400);
    $chartData = $chart->getChartData();
    $workbook = $chartData->getChartDataWorkbook();

    $chartData->getSeries()->clear();
    $chartData->getCategories()->clear();

    $seriesNameCell = $workbook->getCell(0, 0, 1, "Measurements");
    $series = $chartData->getSeries()->add($seriesNameCell, $chart->getType());
    $values = [10, 20, 25, 30, 40];

    for ($i = 0; $i < count($values); $i++) {
        $categoryCell = $workbook->getCell(0, $i + 1, 0, "Day " . ($i + 1));
        $chartData->getCategories()->add($categoryCell);
        $valueCell = $workbook->getCell(0, $i + 1, 1, $values[$i]);
        $series->getDataPoints()->addDataPointForLineSeries($valueCell);
    }

    // A 3. napot valóban üresen hagyja, miközben megtartja a kategóriát és az adatpontot.
    $workbook->getCell(0, 3, 1)->setValue(null);

    $modes = [DisplayBlanksAsType::Gap, DisplayBlanksAsType::Zero, DisplayBlanksAsType::Span];
    $modeNames = ["Gap", "Zero", "Span"];
    for ($i = 0; $i < count($modes); $i++) {
        $chart->setDisplayBlanksAs($modes[$i]);
        $presentation->save("empty_cells_" . $modeNames[$i] . ".pptx", SaveFormat::Pptx);
    }
} finally {
    $presentation->dispose();
}

Minden kimeneti fájl a mentés előtt beállított módot tárolja: empty_cells_Gap.pptx, empty_cells_Zero.pptx és empty_cells_Span.pptx. Ha csak egy verziót akar menteni, állítsa be a kívánt módot, és egyszer mentse a bemutatót a módok ismétlése helyett.

Az alábbi összehasonlítás ugyanazt az adatot mutatja mindhárom fájlban. A 3. nap minden esetben üres a munkafüzetben:

Line charts with identical data: Gap breaks the line at Day 3, Zero drops the line to zero, and Span connects Day 2 to Day 4.

A látható hatás a diagram típusától függ. Egy vonaldiagram egyszerűen összehasonlítható mindhárom móddal. Sáv‑ és oszlopdiagramok esetén nincs vonal, amely a hiányzó kategória felett összekötné a pontokat, így a Span nem hozhat létre összekötő szegmenst; egy hiányzó oszlop és egy nulla‑magasságú oszlop hasonlóan nézhet ki. Hasonlóképpen egy szórt diagram csak jelölőkkel nem rendelkezik vonallal. Ne várjon három különböző eredményt minden diagramtípusnál; ellenőrizze a kimenetet a saját típusában.

Sorozat réstávolság beállítása

A réstávolság a szomszédos sáv‑ vagy oszlopcsoportok közötti helyköz, a sáv vagy oszlop szélességének százalékában kifejezve. Az átfedéshez hasonlóan ez a szülő sorozatcsoporthoz tartozik, nem egyetlen sorozathoz. Hívja a ChartSeriesGroup::setGapWidth metódust egyszer a csoportra. Nagyobb érték nagyobb hézagot eredményez a csoportok között; kisebb érték sűrűbb elrendezést.

Az alábbi példa módosítja a réstávolságot, és csak a végleges bemutatót menti el:

$firstSlideIndex = 0;
$firstSeriesIndex = 0;
$gapWidthPercent = 30;

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

    $chart = $slide->getShapes()->addChart(ChartType::StackedColumn, 20, 20, 500, 200);

    $series = $chart->getChartData()->getSeries()->get_Item($firstSeriesIndex);
    $series->getParentSeriesGroup()->setGapWidth($gapWidthPercent);

    $presentation->save("gap_width_30.pptx", SaveFormat::Pptx);
} finally {
    if (!java_is_null($presentation)) {
        $presentation->dispose();
    }
}

Az eredmény:

The gap width

Sorozatvonalak megjelenítése vagy elrejtése

A sorozatvonalak vizuálisan összekötik a diagram kapcsolódó részeit. Használja a ChartSeriesGroup::setSeriesLines metódust a támogatott rétegelt sáv‑ és OfPie diagramokban történő megjelenítésükre vagy elrejtésükre. Két dimenziós rétegelt sáv‑ és oszlopdiagramokban a vonalak a megfelelő réteghatárokat kötik össze a kategóriák között. Pie of Pie és Bar of Pie diagramokban a fő diagramot kötik a másodlagos diagramhoz. Ez a beállítás nem általános csatlakozó más diagramtípusok számára.

A csoportot a ChartSeries::getParentSeriesGroup metódussal érheti el. A beállítás minden sorozatra hat a csoportban. A ChartSeries::hasSeriesLines csak olvasható, és a szülőcsoport beállítását tükrözi; a csoport beállítóját kell meghívni a módosításhoz.

Az alábbi példa egy ChartType::PieOfPie diagramot hoz létre alapértelmezett adatokkal. Elmenti ugyanazt a diagramot a sorozatvonalak engedélyezésével, majd letiltásával, így két bemutatót kap összehasonlításra.

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::PieOfPie, 50, 50, 600, 400);
    $series = $chart->getChartData()->getSeries()->get_Item(0);
    $seriesGroup = $series->getParentSeriesGroup();

    $seriesGroup->setSeriesLines(true);
    $presentation->save("series_lines_enabled.pptx", SaveFormat::Pptx);

    $seriesGroup->setSeriesLines(false);
    $presentation->save("series_lines_disabled.pptx", SaveFormat::Pptx);
} finally {
    $presentation->dispose();
}
Sorozatvonalak engedélyezve Sorozatvonalak letiltva
Pie of Pie chart with series lines enabled Pie of Pie chart with series lines disabled
A két vonal a fő tortát köti a másodlagos tortához. Mindkét torta látható, de a csatlakozó vonalak rejtve vannak.

A sorozatvonalak különböznek az adatcímke vezetővonalaitól, amelyek a címkéket kötik az adatpontokhoz; a rácsvonalaktól, amelyek a diagram tengelye mentén jelzik az intervallumokat; és a vonaldiagram vonalaitól, amelyek az adatértékeket ábrázolják. Ez a beállítás nem irányítja ezeket az elemeket.

GYIK

Mely diagramtípusok támogatják az adat sorozatokat?

Az összes, a ChartType felsorolásban szereplő diagramtípus használ diagram adatokat, de a sorozataik nem mindegyiknek azonos értékstruktúrája vagy beállítása. Például a kategória diagramok kategóriákat és értékeket használnak, a szórt diagramok X és Y értékeket, a buborék diagramok pedig buborékméreteket. A sorozattípusnak megfelelő adatpont‑létrehozó metódust kell használni. Az olyan opciók, mint az átfedés és a réstávolság, csak kompatibilis sáv‑ vagy oszlopcsoportokra vonatkoznak.

Mi az a diagram sorozatcsoport?

A ChartSeriesGroup kompatibilis sorozatokat tartalmaz, amelyek közös csoportszintű ábrázolási beállításokat osztanak meg. Egy kombinációs diagram több csoportot is tartalmazhat, így egy sorozaton keresztül elérhető csoport módosítása nem feltétlenül változtatja meg a diagram összes sorozatát.

Tartalmaz-e egy újonnan létrehozott diagram alapértelmezett adatot?

Igen. Alapértelmezés szerint a ShapeCollection::addChart mintasorozatokat, kategóriákat és értékeket hoz létre. Ezeket a cellákat szerkesztheti, vagy a sorozat‑ és kategóriagyűjteményeket is törölheti, mielőtt teljesen egyedi adatkészletet adna hozzá. Egy túlterhelés szintén létrehozhat diagramot alapértelmezett adatok nélkül.

Hogyan kapcsolódnak a diagramobjektumok a munkafüzet‑cellákhoz?

A sorozatnevek, kategóriacímkék és adatpont‑értékek a ChartDataWorkbook celláira hivatkoznak. Egy hivatkozott cella módosítása frissíti a megfelelő diagramelemet. Egyedi adatok építésekor tartsa összehangoltan a kategória‑sorokat és a sorozat‑érték‑sorokat, hogy minden pont a megfelelő kategória alá kerüljön.

Hogyan törölhetem egy pontot a teljes sorozat helyett?

Állítsa a megfelelő értékcella null‑ra, hogy a pont kategóriahelye üres pontként maradjon. A ChartDataPointCollection::clear metódust csak akkor használja, ha az összes pontot el akarja távolítani a sorozatból. Ha a kategóriákat is eltávolítja, frissítse minden sorozatot, hogy az értékek a kategóriagyűjteménnyel továbbra is összeilljenek.

Hogyan jelennek meg az üres pontok?

Az eredmény a diagram típusa és a Chart::setDisplayBlanksAs konfigurált értéke szerint alakul. A támogatott diagramok a hiányzó pontokat megszakításként, nullaként vagy a szomszédos pontok összekapcsolásával jeleníthetik meg. Válassza ki a beállítást, amely a hiányzó adatok jelentésének leginkább megfelel a prezentációjában. Lásd a Control the Display of Empty Cells részt a teljes példáért és a vizuális összehasonlításért.

Hogyan formázódnak a negatív értékek?

A támogatott sáv‑, oszlop‑ és buborék sorozatok esetén hívja a ChartSeries::setInvertIfNegative metódust, és állítsa be a ChartSeries::getInvertedSolidFillColor által visszaadott színt. Egy egyedi pontra a ChartDataPoint::setInvertIfNegative segítségével felülírhatja a viselkedést. Ezek a metódusok a formázást befolyásolják, nem a tárolt numerikus értékeket.

Melyik formázás nyer, ha egy sorozat és egy pont is formázva van?

A kifejezett adatpont‑formázás felülbírálja a sorozat formázását az adott pontnál. A többi pont továbbra is a kifejezett sorozatformátumot vagy, ha az nincs definiálva, a automatikus diagramstílust és témát használja. A csoport beállításai, mint az átfedés és a réstávolság, az elrendezést szabályozzák, és nem pont‑szintű formázási felülbírálásként működnek.

Van korlátozás arra, hogy hány sorozatot tartalmazhat egy diagram?

Az Aspose.Slides nem szab ki különálló fix sorozatszám‑korlátot. Gyakorlatilag a bemutató‑fájl korlátai, a rendelkezésre álló memória, a renderelési idő és a diagram olvashatósága határozza meg a hasznos határt.

Mit kell módosítanom, ha a oszlopok túl közel vagy túl távol vannak egymástól?

Hívja a ChartSeriesGroup::setGapWidth metódust a megfelelő szülő sorozatcsoporton. Növelje az értéket a csoportok közti hézag szélesítéséhez, vagy csökkentse, ha közelebb szeretné őket hozni.