Grafiekgegevensreeksen beheren in presentaties op Android
Overzicht
Een grafiek kan haar afgebeelde waarden opslaan in werkbladcellen of rechtstreeks als numerieke literalen. Een IChartSeries vertegenwoordigt één set verwante waarden, en elke IChartDataPoint vertegenwoordigt een punt in die reeks. IChartCategory‑objecten leveren de labels of groeperingswaarden die door de reeksen worden gedeeld. In grafieken die met standaardgegevens zijn aangemaakt, gebruiken reeks‑namen, categorieën en puntwaarden IChartDataCell‑objecten uit het grafiek‑werkblad.
Voor een typische categorie‑grafiek gebruikt het standaard‑werkblad rij 0 voor reeksnamen, kolom 0 voor categorienamen en de overige cellen voor reekswaarden. Werkblad‑, rij‑ en kolom‑indexen die aan IChartDataWorkbook.getCell worden doorgegeven, zijn nul‑gebaseerd. Deze indeling is handig wanneer je een grafiek met standaardgegevens maakt, maar ga er niet van uit dat elke bestaande grafiek deze indeling gebruikt. Voor een geladen presentatie, inspecteer de cellen waarnaar de reeksen, categorieën en datapunten verwijzen voordat je werkbladwaarden wijzigt.
Grafiek‑instellingen hebben drie verschillende scopes:
- Instellingen op reekseniveau, zoals IChartSeries.getFormat, bepalen het standaard‑uiterlijk voor alle punten in één reeks.
- Instellingen op puntniveau, zoals IChartDataPoint.getFormat, overschrijven het reeks‑uiterlijk voor één punt.
- Groepsinstellingen zijn van toepassing op compatibele reeksen die tot dezelfde IChartSeriesGroup behoren. Open de groep via IChartSeries.getParentSeriesGroup wanneer je opties wilt instellen, zoals overlap of de breedte van de ruimte tussen staven.
Wanneer er geen expliciete punt‑ of reeks‑vulling is ingesteld, bepalen de grafiekstijl en het thema het automatische uiterlijk. Wanneer zowel reeks‑ als punt‑opmaak aanwezig zijn, heeft de punt‑opmaak voorrang voor dat punt.

Voor een gegroepeerde cilinder‑grafiek, zie hoe het wijzigen van het 3D‑reeks‑type of de staafvorm de eerste reeks beïnvloedt.
Reekswerte instellen met numerieke literalen
Gebruik numerieke literalen wanneer reekswerte afkomstig zijn van toepassingsdata of berekeningen en geen verwijzingen naar werkbladcellen nodig hebben. Roep setDataSourceTypeForValues aan met DataSourceType.DoubleLiterals vóór het toewijzen van elk punt‑getValue resultaat via setAsLiteralDouble.
De collectiesetting bepaalt het brontype van alle puntwaarden in die reeks. Elke puntwaarde‑getDataSourceType‑methode meldt het geselecteerde type; wijzig het via de collectiesetting. Met Worksheet gebruik je getAsCell om de gerefereerde cel te benaderen. Met DoubleLiterals gebruik je getAsLiteralDouble of setAsLiteralDouble om het getal direct te lezen of te schrijven.
Het volgende voorbeeld maakt een kolomgrafiek met standaardreeksen en -categorieën, en kent vervolgens berekende waarden van 10, 20, enzovoort toe aan de bestaande punten van de eerste reeks. Het slaat de presentatie op, opent deze opnieuw en drukt de opgeslagen waarden af.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 300);
IChartSeries series = chart.getChartData().getSeries().get_Item(0);
series.getDataPoints().setDataSourceTypeForValues(DataSourceType.DoubleLiterals);
for (int i = 0; i < series.getDataPoints().size(); i++) {
series.getDataPoints().get_Item(i).getValue().setAsLiteralDouble((i + 1) * 10);
}
presentation.save("numeric_literals.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Presentation reopenedPresentation = new Presentation("numeric_literals.pptx");
try {
ISlide reopenedSlide = reopenedPresentation.getSlides().get_Item(0);
IChart reopenedChart = (IChart) reopenedSlide.getShapes().get_Item(0);
IChartSeries reopenedSeries = reopenedChart.getChartData().getSeries().get_Item(0);
for (IChartDataPoint point : reopenedSeries.getDataPoints()) {
System.out.println(point.getValue().getAsLiteralDouble());
}
} finally {
reopenedPresentation.dispose();
}
Het puntwaarde‑brontype staat los van IChartData.getDataSourceType, dat de interne of externe werkbladconfiguratie van de grafiek identificeert. Het gebruik van numerieke literalen verwijdert op zichzelf de ingebedde werkmap niet. In dit voorbeeld blijft de werkmap beschikbaar voor categorielabels, reeksnamen en de andere reeksen. Zie Grafiek‑werkmap voor werkboekbeheer.
Voor spreidings‑ en bubbelgrafieken gebruik je setDataSourceTypeForXValues en setDataSourceTypeForYValues om de bron voor getXValue en getYValue te kiezen. Bubbelgrafieken gebruiken tevens setDataSourceTypeForBubbleSizes voor getBubbleSize. Stel elke toepasselijke bron in op DoubleLiterals vóór het toewijzen van getallen via de setAsLiteralDouble‑methode van die waarde.
Overlap van reeksen instellen
IChartSeries.getOverlap geeft aan hoeveel staven of kolommen elkaar overlappen in een 2D‑grafiek, van -100 tot 100 procent. Het is een alleen‑lezen projectie van de instelling op de bovenliggende reeksgroep. Gebruik IChartSeriesGroup.setOverlap om elke compatibele reeks in die groep bij te werken. Deze optie is van toepassing op grafiektypen die gegroepeerde staven of kolommen tonen; hij heeft geen invloed op niet‑gerelateerde reeksgroepen in een combinatie‑grafiek.
Het volgende voorbeeld stelt de overlap in voor de groep die de eerste reeks bevat:
import com.aspose.slides.*;
final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final byte overlapPercent = 30;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
// De nieuwe grafiek bevat voorbeeldreeksen, categorieën en waarden.
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
series.getParentSeriesGroup().setOverlap(overlapPercent);
presentation.save("series_overlap.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Resultaat:

Kleur van de reeksvulling wijzigen
Gebruik IChartSeries.getFormat om de standaardvulling voor een volledige reeks in te stellen. Als een punt al een expliciete vulling heeft, overschrijft de IChartDataPoint.getFormat‑instelling de reeksvulling voor dat punt.
Het volgende voorbeeld past een egale blauwe vulling toe op de eerste reeks:
import com.aspose.slides.*;
import android.graphics.Color;
final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
series.getFormat().getFill().setFillType(FillType.Solid);
series.getFormat().getFill().getSolidFillColor().setColor(Color.BLUE);
presentation.save("series_color.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Resultaat:

Naam van de reeks wijzigen
Een reeksnamen wordt opgeslagen in het grafiek‑datwerkblad en normaal weergegeven in de legenda. In het standaard‑werkblad dat wordt aangemaakt voor een gegroepeerde kolomgrafiek bevindt cel B1 zich op rij 0, kolom 1 en bevat de naam van de eerste reeks. De benoemde constanten in het volgende voorbeeld maken die structuur expliciet:
import com.aspose.slides.*;
final int firstSlideIndex = 0;
final int worksheetIndex = 0;
final int seriesNameRowIndex = 0;
final int firstSeriesColumnIndex = 1;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, seriesNameRowIndex, firstSeriesColumnIndex);
seriesNameCell.setValue("Revenue");
presentation.save("series_name.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Je kunt ook de cel bijwerken die al wordt gerefereerd door IChartSeries.getName. Deze benadering voorkomt dat je een specifieke rij en kolom in een bestaande grafiek moet aannemen:
import com.aspose.slides.*;
final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int firstNameCellIndex = 0;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
IChartDataCell seriesNameCell = series.getName().getAsCells().get_Item(firstNameCellIndex);
seriesNameCell.setValue("Revenue");
presentation.save("series_name.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Resultaat:

Een reeks maken met een naam uit meerdere cellen
Een samengestelde reeksennaam is nuttig wanneer een productnaam en een rapportageperiode in aparte werkbladcellen worden bewaard. Bijvoorbeeld, je kunt Product A in B1 en 2026 in C1 combineren tot één reeksennaam, terwijl beide delen gelinkt blijven aan hun broncellen.
Gebruik IChartDataWorkbook.getCellCollection om het naam‑bereik op te halen, en geef die collectie door aan IChartSeriesCollection.add. Het argument skipHiddenCells bepaalt of verborgen cellen worden meegenomen: true sluit ze uit, false neemt ze op. Dit voorbeeld gebruikt false om elke cel in het naam‑bereik op te nemen.
Het volgende voorbeeld maakt een presentatie met één reeks en twee datapunten. Cellen B1:C1 leveren alleen de reeksennaam; A2:A3 leveren de categorielabels, en B2:B3 leveren de numerieke waarden.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 50, 50, 620, 180);
chart.getChartData().getSeries().clear();
chart.getChartData().getCategories().clear();
chart.setLegend(true);
IChartDataWorkbook workbook = chart.getChartData().getChartDataWorkbook();
workbook.clear(0);
// Deze twee cellen leveren de reeksnaam.
workbook.getCell(0, 0, 1, "Product A");
workbook.getCell(0, 0, 2, "2026");
IChartCellCollection nameCells = workbook.getCellCollection("Sheet1!$B$1:$C$1", false);
IChartSeries series = chart.getChartData().getSeries().add(nameCells, ChartType.ClusteredColumn);
// Aparte cellen leveren de categorieën en numerieke datapunten.
IChartDataCell northCategory = workbook.getCell(0, 1, 0, "North");
IChartDataCell southCategory = workbook.getCell(0, 2, 0, "South");
chart.getChartData().getCategories().add(northCategory);
chart.getChartData().getCategories().add(southCategory);
IChartDataCell northValue = workbook.getCell(0, 1, 1, 120);
IChartDataCell 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();
}
De resulterende reeksennaam is Product A 2026, met een spatie tussen de twee celwaarden. De legenda toont dit als één vermelding voor beide kolommen. De afbeelding hieronder illustreert het resultaat:

Automatische vullingskleur van de reeks ophalen
IChartSeries.getAutomaticSeriesColor retourneert de kleur die is berekend op basis van de reeksen‑index en de grafiekstijl als een Android ARGB‑kleur‑integer. Dit is de kleur die wordt gebruikt wanneer de reeksvulling niet expliciet is gedefinieerd. Het aanroepen van de methode leest de berekende kleur; hij wijst geen nieuwe vulling toe.
Het volgende voorbeeld drukt de automatische kleur‑integer van elke standaardreeks af:
import com.aspose.slides.*;
final int firstSlideIndex = 0;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
int seriesCount = chart.getChartData().getSeries().size();
for (int seriesIndex = 0; seriesIndex < seriesCount; seriesIndex++) {
IChartSeries series = chart.getChartData().getSeries().get_Item(seriesIndex);
int automaticColor = series.getAutomaticSeriesColor();
System.out.println("Series " + seriesIndex + ": " + automaticColor);
}
} finally {
presentation.dispose();
}
De exacte integer‑waarden hangen af van de grafiekstijl en het thema.
Inverted‑vullingskleur voor een reeksgrafiek instellen
Voor staaf‑, kolom‑ en bubbelreeksen kan IChartSeries.setInvertIfNegative negatieve waarden met een andere vulling weergeven. Stel de gewone reeksvulling in op een egale kleur, schakel inversie in, en wijs de negatieve‑waarde‑kleur toe via IChartSeries.getInvertedSolidFillColor. Negatieve getallen blijven ongewijzigd in het werkblad; alleen hun weergavekleur verandert.
Het volgende voorbeeld vervangt de standaardgrafiek‑data door één reeks. Werkbladrij 0 bevat de reeksnamen, kolom 0 bevat categorienamen, en kolom 1 bevat de waarden:
import com.aspose.slides.*;
import android.graphics.Color;
final int firstSlideIndex = 0;
final int worksheetIndex = 0;
final int headerRowIndex = 0;
final int categoryColumnIndex = 0;
final int firstSeriesColumnIndex = 1;
final int firstDataRowIndex = 1;
String[] categoryNames = { "Category 1", "Category 2", "Category 3" };
int[] seriesValues = { -20, 50, -30 };
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartData chartData = chart.getChartData();
IChartDataWorkbook workbook = chartData.getChartDataWorkbook();
chartData.getSeries().clear();
chartData.getCategories().clear();
IChartDataCell seriesNameCell = workbook.getCell(worksheetIndex, headerRowIndex, firstSeriesColumnIndex, "Series 1");
int chartType = chart.getType();
IChartSeries series = chartData.getSeries().add(seriesNameCell, chartType);
for (int categoryIndex = 0; categoryIndex < categoryNames.length; categoryIndex++) {
int dataRowIndex = firstDataRowIndex + categoryIndex;
String categoryName = categoryNames[categoryIndex];
int seriesValue = seriesValues[categoryIndex];
IChartDataCell categoryCell = workbook.getCell(worksheetIndex, dataRowIndex, categoryColumnIndex, categoryName);
chartData.getCategories().add(categoryCell);
IChartDataCell valueCell = workbook.getCell(worksheetIndex, dataRowIndex, firstSeriesColumnIndex, seriesValue);
series.getDataPoints().addDataPointForBarSeries(valueCell);
}
int automaticSeriesColor = series.getAutomaticSeriesColor();
series.getFormat().getFill().setFillType(FillType.Solid);
series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
series.setInvertIfNegative(true);
series.getInvertedSolidFillColor().setColor(Color.RED);
presentation.save("inverted_solid_fill_color.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Resultaat:

Je kunt inversie voor één punt inschakelen via IChartDataPoint.setInvertIfNegative. In het volgende voorbeeld is inversie uitgeschakeld voor de reeks en alleen ingeschakeld voor het geselecteerde punt. Het punt krijgt tevens een negatieve waarde zodat het effect zichtbaar is:
import com.aspose.slides.*;
import android.graphics.Color;
final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int targetDataPointIndex = 2;
final int negativeValue = -30;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
int automaticSeriesColor = series.getAutomaticSeriesColor();
series.getFormat().getFill().setFillType(FillType.Solid);
series.getFormat().getFill().getSolidFillColor().setColor(automaticSeriesColor);
series.getInvertedSolidFillColor().setColor(Color.RED);
series.setInvertIfNegative(false);
IChartDataPoint 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 {
presentation.dispose();
}
Specifieke datapuntenwaarde wissen
Om één punt leeg te maken zonder de andere punten te verwijderen, stel je de onderliggende werkbladcel in op null. Voor een kolomgrafiek is de afgebeelde waarde beschikbaar via IChartDataPoint.getValue. Het datapunt blijft op dezelfde categorie‑positie, maar de grafiek behandelt de waarde als leeg volgens de instellingen voor lege waarden van de grafiek.
Het volgende voorbeeld wist alleen het tweede punt in de eerste reeks:
import com.aspose.slides.*;
final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int targetDataPointIndex = 1;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
IChartDataPoint dataPoint = series.getDataPoints().get_Item(targetDataPointIndex);
dataPoint.getValue().getAsCell().setValue(null);
presentation.save("clear_data_point_value.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Spreidingsgrafieken gebruiken aparte X‑ en Y‑cellen, en bubbelgrafieken ook een grootte‑cel. Wis alleen de cel die de waarde vertegenwoordigt die je wilt verwijderen. Roep niet IChartDataPointCollection.clear aan als je de andere punten wilt behouden, want die methode verwijdert elk datapunt uit de collectie.
Weergave van lege cellen regelen
Verborgen cellen die waarden bevatten vormen een apart geval ten opzichte van lege cellen. Om gegevens uit verborgen werkbladrijen en -kolommen wel of niet op te nemen, zie Gegevens opnemen uit verborgen rijen en kolommen.
Een lege werkbladcel vertegenwoordigt missende data; een cel met 0 vertegenwoordigt een bekende numerieke waarde. Roep IChartDataCell.setValue aan met null om een cel leeg te maken. Een numerieke nul blijft een nul, ongeacht de instelling voor lege cellen.
Gebruik IChart.setDisplayBlanksAs om te kiezen hoe de grafiek lege cellen weergeeft. Deze instelling geldt voor de hele grafiek. Hij verandert hoe lege waarden worden uitgezet, zonder de lege werkbladcel te vullen met nul of een geïnterpoleerde waarde.
Het volgende zelf‑containende voorbeeld maakt een lijngrafiek met één reeks, wist de waarde voor Dag 3, en slaat dezelfde grafiek op met elke modus. Er is geen invoerbestand nodig. De IChartDataWorkbook gebruikt werkblad 0, kolom 0 voor categorielabels, en kolom 1 voor waarden; rij 0 bevat de reeksnamen. De uiteindelijke data is 10, 20, leeg, 30, 40.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.LineWithMarkers, 40, 40, 640, 400);
IChartData chartData = chart.getChartData();
IChartDataWorkbook workbook = chartData.getChartDataWorkbook();
chartData.getSeries().clear();
chartData.getCategories().clear();
IChartDataCell seriesNameCell = workbook.getCell(0, 0, 1, "Measurements");
IChartSeries series = chartData.getSeries().add(seriesNameCell, chart.getType());
int[] values = { 10, 20, 25, 30, 40 };
for (int i = 0; i < values.length; i++) {
IChartDataCell categoryCell = workbook.getCell(0, i + 1, 0, "Day " + (i + 1));
chartData.getCategories().add(categoryCell);
IChartDataCell valueCell = workbook.getCell(0, i + 1, 1, values[i]);
series.getDataPoints().addDataPointForLineSeries(valueCell);
}
// Laat Dag 3 echt leeg, terwijl de categorie en het datapunt behouden blijven.
workbook.getCell(0, 3, 1).setValue(null);
int[] modes = { DisplayBlanksAsType.Gap, DisplayBlanksAsType.Zero, DisplayBlanksAsType.Span };
String[] modeNames = { "Gap", "Zero", "Span" };
for (int i = 0; i < modes.length; i++) {
chart.setDisplayBlanksAs(modes[i]);
presentation.save("empty_cells_" + modeNames[i] + ".pptx", SaveFormat.Pptx);
}
} finally {
presentation.dispose();
}
Elk uitvoerbestand slaat de modus op die vóór het opslaan is ingesteld: empty_cells_Gap.pptx, empty_cells_Zero.pptx en empty_cells_Span.pptx. Om slechts één versie op te slaan, stel je de gewenste modus in en sla je de presentatie één keer op in plaats van over alle modi te itereren.
De onderstaande vergelijking toont dezelfde data in alle drie de bestanden. Dag 3 is in elk geval leeg in het werkblad:

Het zichtbare effect hangt af van het grafiektype. Een lijngrafiek maakt alle drie de modi makkelijk vergelijkbaar. Staaf‑ en kolomgrafieken hebben geen lijn die over een ontbrekende categorie kan worden getrokken, zodat Span de verbindingssegmenten niet kan produceren; een ontbrekende kolom en een kolom met nulhoogte kunnen er ook gelijk uitzien. Evenzo heeft een spreidingsgrafiek met alleen markers geen verbindingslijn. Verwacht niet dat elke grafiek drie verschillende resultaten oplevert; controleer de uitvoer voor het type dat je gebruikt.
Breedte van de reeks-gap instellen
De gap‑breedte is de ruimte tussen aangrenzende staaf‑ of kolom‑clusters, uitgedrukt als een percentage van de staaf‑ of kolom‑breedte. Net als overlap behoort hij tot de bovenliggende reeksgroep i.p.v. tot één enkele reeks. Roep IChartSeriesGroup.setGapWidth één keer aan voor de groep. Een hogere waarde creëert meer ruimte tussen clusters; een lagere waarde maakt ze dichter op elkaar.
Het volgende voorbeeld verandert de gap‑breedte en slaat alleen de uiteindelijke presentatie op:
import com.aspose.slides.*;
final int firstSlideIndex = 0;
final int firstSeriesIndex = 0;
final int gapWidthPercent = 30;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(firstSlideIndex);
IChart chart = slide.getShapes().addChart(ChartType.StackedColumn, 20, 20, 500, 200);
IChartSeries series = chart.getChartData().getSeries().get_Item(firstSeriesIndex);
series.getParentSeriesGroup().setGapWidth(gapWidthPercent);
presentation.save("gap_width_30.pptx", SaveFormat.Pptx);
} finally {
presentation.dispose();
}
Resultaat:

Reeks‑lijnen weergeven of verbergen
Reeks‑lijnen verbinden visueel verwante delen van een grafiek. Gebruik IChartSeriesGroup.setSeriesLines om ze weer te geven of te verbergen in ondersteunde gestapelde staaf‑ en OfPie‑grafieken. In tweedimensionale gestapelde staaf‑ en kolomgrafieken verbinden zij de overeenkomstige stapelgrenzen over categorieën heen. In Pie of Pie‑ en Bar of Pie‑grafieken verbinden ze de hoofdplot met de secundaire plot. Deze instelling is geen algemene connector voor andere grafiektypen.
Open de groep via IChartSeries.getParentSeriesGroup. De instelling is van toepassing op elke reeks in die groep. IChartSeries.hasSeriesLines is alleen‑lezen en geeft de instelling van de bovenliggende groep weer; roep de setter van de groep aan om deze bij te werken.
Het volgende voorbeeld maakt één PieOfPie‑grafiek met standaarddata. Het slaat dezelfde grafiek op met reeks‑lijnen ingeschakeld en vervolgens uitgeschakeld, waardoor twee presentaties voor vergelijking ontstaan.
import com.aspose.slides.*;
Presentation presentation = new Presentation();
try {
ISlide slide = presentation.getSlides().get_Item(0);
IChart chart = slide.getShapes().addChart(ChartType.PieOfPie, 50, 50, 600, 400);
IChartSeries series = chart.getChartData().getSeries().get_Item(0);
IChartSeriesGroup 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();
}
| Reeks‑lijnen ingeschakeld | Reeks‑lijnen uitgeschakeld |
|---|---|
![]() |
![]() |
| De twee lijnen verbinden de hoofd‑pie met de secundaire pie. | Beide pie’s blijven zichtbaar, maar de verbindingslijnen zijn verborgen. |
Reeks‑lijnen verschillen van gegevenslabel‑leidingslijnen, die labels verbinden met hun datapunten; van rasterlijnen, die intervallen langs de assen markeren; en van de lijnen in een lijngrafiek, die de gegevenswaarden representeren. Deze instelling regelt die elementen niet.
FAQ
Welke grafiektypen ondersteunen gegevensreeksen?
Alle grafiektypen die worden vertegenwoordigd door de ChartType‑enumeratie gebruiken grafiekdata, maar hun reeksen hebben niet allemaal dezelfde waardestructuur of instellingen. Bijvoorbeeld, categorie‑grafieken gebruiken categorieën en waarden, spreidingsgrafieken gebruiken X‑ en Y‑waarden, en bubbelgrafieken voegen bubbelgroottes toe. Gebruik de datapunt‑creatiemethode die overeenkomt met het reekstyp. Opties zoals overlap en gap‑width zijn alleen van toepassing op compatibele staaf‑ of kolomgroepen.
Wat is een grafiek‑reeks‑groep?
Een IChartSeriesGroup bevat compatibele reeksen die groeps‑niveau plot‑instellingen delen. Een combinatie‑grafiek kan meer dan één groep bevatten, dus het wijzigen van de groep die via één reeks wordt bereikt, verandert niet noodzakelijkerwijs elke reeks in de grafiek.
Bevat een nieuw aangemaakte grafiek standaarddata?
Ja. Standaard maakt IShapeCollection.addChart voorbeeld‑reeksen, -categorieën en -waarden aan. Je kunt die cellen bewerken of zowel de reeksen‑ als de categorie‑collecties wissen voordat je een volledig aangepaste dataset toevoegt. Een overload kan ook een grafiek maken zonder standaarddata.
Hoe zijn grafiekobjecten verbonden met werkbladcellen?
Reeksnamen, categorielabels en datapunten‑waarden verwijzen naar cellen in een IChartDataWorkbook. Het wijzigen van een gerefereerde cel werkt het corresponderende grafiekelement bij. Wanneer je aangepaste data opbouwt, houd dan de categorierijen en reeksen‑waardrijen op één lijn zodat elk punt onder de juiste categorie wordt uitgezet.
Hoe wis ik één punt in plaats van de hele reeks?
Stel de betreffende waardecel in op null om de positie van het punt in de categorie te behouden als een leeg punt. Gebruik IChartDataPointCollection.clear alleen wanneer je alle punten uit die reeks wilt verwijderen, want die methode verwijdert elk datapunt uit de collectie.
Hoe worden lege punten weergegeven?
Het resultaat hangt af van het grafiektype en de waarde die is geconfigureerd via IChart.setDisplayBlanksAs. Ondersteunde grafieken kunnen lege waarden weergeven als gaten, als nul‑waarden, of door naburige punten te verbinden. Kies de instelling die past bij de betekenis van missende data in je presentatie. Zie Weergave van lege cellen regelen voor een volledig voorbeeld en visuele vergelijking.
Hoe worden negatieve waarden opgemaakt?
Voor ondersteunde staaf‑, kolom‑ en bubbelreeksen roep je IChartSeries.setInvertIfNegative aan en stel je de kleur in die wordt geretourneerd door IChartSeries.getInvertedSolidFillColor. Je kunt het gedrag voor een individueel punt overschrijven met IChartDataPoint.setInvertIfNegative. Deze methoden beïnvloeden de opmaak, niet de opgeslagen numerieke waarden.
Welke opmaak wint wanneer zowel een reeks als een punt zijn opgemaakt?
Expliciete datapunt‑opmaak heeft voorrang voor dat punt. Andere punten blijven de expliciete reeks‑opmaak of, wanneer de reeks‑opmaak niet is gedefinieerd, de automatische grafiekstijl en het thema gebruiken. Groepsinstellingen zoals overlap en gap‑width regelen de lay‑out en zijn geen punt‑niveau opmaak‑overschrijvingen.
Is er een limiet aan het aantal reeksen dat een grafiek kan bevatten?
Aspose.Slides legt geen aparte vaste limiet op voor het aantal reeksen. In de praktijk bepalen presentatie‑bestandbeperkingen, beschikbaar geheugen, render‑tijd en de leesbaarheid van de grafiek een praktisch limiet.
Wat moet ik aanpassen wanneer kolommen te dicht bij elkaar staan of te ver uit elkaar liggen?
Roep IChartSeriesGroup.setGapWidth aan op de betreffende bovenliggende reeksgroep. Verhoog de waarde om de ruimte tussen clusters te vergroten, of verlaag deze om de clusters dichter bij elkaar te brengen.

