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.

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:

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:

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:

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:

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:

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 levoná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:

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:

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 |
|---|---|
![]() |
![]() |
| 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.

