Beheer Grafiekgegevensreeksen in Presentaties met Python

Overzicht

Een diagram kan zijn weergegeven waarden opslaan in werkboekcellen of rechtstreeks als numerieke literal‑waarden. Een ChartSeries vertegenwoordigt één set gerelateerde waarden, en elk ChartDataPoint vertegenwoordigt een punt in die reeks. ChartCategory‑objecten leveren de labels of groeperingswaarden die door de reeksen worden gedeeld. In diagrammen die met standaardgegevens worden aangemaakt, gebruiken reeksnamen, categorieën en puntwaarden ChartDataCell‑objecten uit het diagram‑werkboek.

Voor een typische categorische grafiek gebruikt het standaardwerkboek rij 0 voor reeksnamen, kolom 0 voor categorienamen en de resterende cellen voor reekswaarden. Werkblad‑, rij‑ en kolomindexen die aan ChartDataWorkbook.get_cell worden doorgegeven, zijn nulgebaseerd. Deze indeling is handig wanneer u een diagram met standaardgegevens maakt, maar ga er niet van uit dat elk bestaand diagram deze indeling gebruikt. Inspecteer bij een geladen presentatie de cellen die door de reeksen, categorieën en gegevenspunten worden verwezen voordat u werkboekwaarden wijzigt.

Diagraminstellingen hebben drie verschillende scopes:

Wanneer er geen expliciete punt‑ of reeks‑vulling is ingesteld, bepalen de diagramstijl en het thema de automatische opmaak. Wanneer zowel reeks‑ als punt‑opmaak aanwezig zijn, heeft de punt‑opmaak voorrang voor dat punt.

chart-series-powerpoint

Voor een gegroepeerd cilinderdia­gram, zie hoe changing the 3D series type or bar shape de eerste reeks beïnvloedt.

Reekswaarden instellen met numerieke literal‑waarden

Gebruik numerieke literal‑waarden wanneer reekswerte afkomstig zijn uit toepassingsdata of berekeningen en geen verwijzingen naar werkbladcellen nodig hebben. Stel data_source_type_for_values in op DataSourceType.DOUBLE_LITERALS voordat u elke punt‑value via as_literal_double toewijst.

De collectiesetting bepaalt het brontype van alle puntwaarden in die reeks. Elke punt‑value.data_source_type meldt het gekozen type; wijzig het via de collectiesetting. Met WORKSHEET gebruikt u as_cell om de verwijzende cel te benaderen. Met DOUBLE_LITERALS gebruikt u as_literal_double om het getal rechtstreeks te lezen of te schrijven.

Het volgende voorbeeld maakt een kolomdiagram 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 aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 300)
    series = chart.chart_data.series[0]

    series.data_points.data_source_type_for_values = charts.DataSourceType.DOUBLE_LITERALS
    for i in range(len(series.data_points)):
        series.data_points[i].value.as_literal_double = (i + 1) * 10

    presentation.save("numeric_literals.pptx", slides.export.SaveFormat.PPTX)

with slides.Presentation("numeric_literals.pptx") as reopened_presentation:
    reopened_slide = reopened_presentation.slides[0]
    reopened_chart = reopened_slide.shapes[0]
    reopened_series = reopened_chart.chart_data.series[0]
    for point in reopened_series.data_points:
        print(point.value.as_literal_double)

Het bron‑type van de puntwaarde staat los van ChartData.data_source_type, dat de interne of externe werkboekconfiguratie van het diagram identificeert. Het gebruik van numerieke literal‑waarden verwijdert op zichzelf het ingebedde werkboek niet. In dit voorbeeld blijft het werkboek beschikbaar voor categorielabels, reeksnamen en de andere reeksen. Zie Chart Workbook voor werkboekbeheer.

Voor spreidings‑ en bubbel­diagrammen stelt u data_source_type_for_x_values en data_source_type_for_y_values in om de bronnen voor x_value en y_value te kiezen. Bubbel­diagrammen gebruiken ook data_source_type_for_bubble_sizes voor bubble_size. Stel elke toepasselijke bron in op DOUBLE_LITERALS voordat u getallen via de eigenschap as_literal_double van die waarde toekent.

Overlap van diagramreeksen instellen

ChartSeries.overlap geeft aan hoeveel balken of kolommen overlappen in een 2D‑diagram, van –100 tot 100 %. Het is een alleen‑lezen projectie van de instelling op de bovenliggende reeks‑groepsreeks. Stel ChartSeriesGroup.overlap in om elke compatibele reeks in die groep bij te werken. Deze optie geldt voor diagramtypen die gegroepeerde balken of kolommen tonen; hij heeft geen invloed op niet‑gerelateerde reeksgroepen in een combinatie‑diagram.

Het volgende voorbeeld stelt de overlap in voor de groep die de eerste reeks bevat:

import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
first_series_index = 0
overlap_percent = 30

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    # De nieuwe grafiek bevat voorbeeldreeksen, categorieën en waarden.
    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[first_series_index]
    series.parent_series_group.overlap = overlap_percent

    presentation.save("series_overlap.pptx", slides.export.SaveFormat.PPTX)

Resultaat:

The series overlap

Vulkleur van de reeks wijzigen

Gebruik ChartSeries.format om de standaardvulling voor een gehele reeks in te stellen. Als een punt al een expliciete vulling heeft, overschrijft de ChartDataPoint.format‑instelling de reeksvulling voor dat punt.

Het volgende voorbeeld past een effen blauwe vulling toe op de eerste reeks:

import aspose.pydrawing as drawing
import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
first_series_index = 0

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[first_series_index]
    series.format.fill.fill_type = slides.FillType.SOLID
    series.format.fill.solid_fill_color.color = drawing.Color.blue

    presentation.save("series_color.pptx", slides.export.SaveFormat.PPTX)

Resultaat:

The color of the series

Naam van de reeks wijzigen

Een reeksnaam wordt opgeslagen in het diagram‑werkboek en normaal weergegeven in de legenda. In het standaardwerkboek dat wordt aangemaakt voor een gegroepeerd kolomdiagram, 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 aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
worksheet_index = 0
series_name_row_index = 0
first_series_column_index = 1

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    workbook = chart.chart_data.chart_data_workbook
    series_name_cell = workbook.get_cell(worksheet_index, series_name_row_index, first_series_column_index)
    series_name_cell.value = "Revenue"

    presentation.save("series_name.pptx", slides.export.SaveFormat.PPTX)

U kunt ook de cel bijwerken die al door ChartSeries.name wordt verwezen. Deze aanpak voorkomt dat u een bepaalde rij en kolom in een bestaand diagram moet aannemen:

import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
first_series_index = 0
first_name_cell_index = 0

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[first_series_index]
    series_name_cell = series.name.as_cells[first_name_cell_index]
    series_name_cell.value = "Revenue"

    presentation.save("series_name.pptx", slides.export.SaveFormat.PPTX)

Resultaat:

The series name

Een reeks maken met een naam uit meerdere cellen

Een samengestelde reeksnaam is handig wanneer een productnaam en een rapportage‑periode in afzonderlijke werkboekcellen zijn opgeslagen. Bijvoorbeeld, u kunt Product A in B1 en 2026 in C1 combineren tot één reeksnaam terwijl beide delen gekoppeld blijven aan hun broncellen.

Gebruik ChartDataWorkbook.get_cell_collection om het naam‑bereik op te halen, en geef die collectie door aan ChartSeriesCollection.add. Het argument skip_hidden_cells bepaalt of verborgen cellen worden meegenomen: True sluit ze uit, False neemt ze op. In dit voorbeeld gebruiken we False om elke cel in het naam‑bereik op te nemen.

Het volgende voorbeeld maakt een presentatie met één reeks en twee gegevenspunten. Cell​en B1:C1 leveren alleen de reeksnaam; A2:A3 leveren de categorielabels, en B2:B3 leveren de numerieke waarden.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 50, 50, 620, 180)

    chart.chart_data.series.clear()
    chart.chart_data.categories.clear()
    chart.has_legend = True

    workbook = chart.chart_data.chart_data_workbook
    workbook.clear(0)

    # Deze twee cellen leveren de reeksnaam.
    workbook.get_cell(0, 0, 1, "Product A")
    workbook.get_cell(0, 0, 2, "2026")
    name_cells = workbook.get_cell_collection("Sheet1!$B$1:$C$1", False)
    series = chart.chart_data.series.add(name_cells, charts.ChartType.CLUSTERED_COLUMN)

    # Aparte cellen leveren de categorieën en numerieke gegevenspunten.
    north_category = workbook.get_cell(0, 1, 0, "North")
    south_category = workbook.get_cell(0, 2, 0, "South")
    chart.chart_data.categories.add(north_category)
    chart.chart_data.categories.add(south_category)
    north_value = workbook.get_cell(0, 1, 1, 120)
    south_value = workbook.get_cell(0, 2, 1, 150)
    series.data_points.add_data_point_for_bar_series(north_value)
    series.data_points.add_data_point_for_bar_series(south_value)

    presentation.save("composite_series_name.pptx", slides.export.SaveFormat.PPTX)

De resulterende reeksnaam is Product A 2026, met een spatie tussen de twee celwaarden. De legenda toont dit als één item voor beide kolommen. De afbeelding hieronder is gerenderd vanuit de opgeslagen presentatie:

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

Automatische reeksvulkleur ophalen

ChartSeries.get_automatic_series_color geeft de kleur terug die wordt berekend op basis van het reeksindex en de diagramstijl. 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 van elke standaardreeks af:

import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series_count = len(chart.chart_data.series)
    for series_index in range(series_count):
        series = chart.chart_data.series[series_index]
        automatic_color = series.get_automatic_series_color()
        print(f"Series {series_index}: {automatic_color.name}")

Voorbeeldoutput voor de standaarddiagramstijl:

Series 0: ff4f81bd
Series 1: ffc0504d
Series 2: ff9bbb59

De exacte kleuren hangen af van de diagramstijl en het thema.

Omgekeerde vulkleur voor een diagramreeks instellen

Voor balk‑, kolom‑ en bubbelreeksen kan ChartSeries.invert_if_negative negatieve waarden met een andere vulling weergeven. Stel de gewone reeksvulling in op effen, schakel inversie in en wijs de negatieve‑waardekleur toe via ChartSeries.inverted_solid_fill_color. Negatieve getallen blijven ongewijzigd in het werkboek; alleen hun weergavekleur verandert.

Het volgende voorbeeld vervangt de standaarddiagramdata door één reeks. Werkblad‑rij 0 bevat de reeksnaam, kolom 0 bevat categorienamen, en kolom 1 bevat de waarden:

import aspose.pydrawing as drawing
import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
worksheet_index = 0
header_row_index = 0
category_column_index = 0
first_series_column_index = 1
first_data_row_index = 1

category_names = ["Category 1", "Category 2", "Category 3"]
series_values = [-20, 50, -30]

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)
    chart_data = chart.chart_data
    workbook = chart_data.chart_data_workbook

    chart_data.series.clear()
    chart_data.categories.clear()

    series_name_cell = workbook.get_cell(worksheet_index, header_row_index, first_series_column_index, "Series 1")
    series = chart_data.series.add(series_name_cell, chart.type)

    category_count = len(category_names)
    for category_index in range(category_count):
        data_row_index = first_data_row_index + category_index
        category_name = category_names[category_index]
        series_value = series_values[category_index]

        category_cell = workbook.get_cell(worksheet_index, data_row_index, category_column_index, category_name)
        chart_data.categories.add(category_cell)

        value_cell = workbook.get_cell(worksheet_index, data_row_index, first_series_column_index, series_value)
        series.data_points.add_data_point_for_bar_series(value_cell)

    automatic_series_color = series.get_automatic_series_color()
    series.format.fill.fill_type = slides.FillType.SOLID
    series.format.fill.solid_fill_color.color = automatic_series_color
    series.invert_if_negative = True
    series.inverted_solid_fill_color.color = drawing.Color.red

    presentation.save("inverted_solid_fill_color.pptx", slides.export.SaveFormat.PPTX)

Resultaat:

The inverted solid fill color

U kunt inversie voor één punt inschakelen via ChartDataPoint.invert_if_negative. In het volgende voorbeeld is inversie uitgeschakeld voor de reeks en alleen ingeschakeld voor het geselecteerde punt. Het punt krijgt bovendien een negatieve waarde zodat het effect zichtbaar is:

import aspose.pydrawing as drawing
import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
first_series_index = 0
target_data_point_index = 2
negative_value = -30

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[first_series_index]
    automatic_series_color = series.get_automatic_series_color()
    series.format.fill.fill_type = slides.FillType.SOLID
    series.format.fill.solid_fill_color.color = automatic_series_color
    series.inverted_solid_fill_color.color = drawing.Color.red
    series.invert_if_negative = False

    data_point = series.data_points[target_data_point_index]
    data_point.value.as_cell.value = negative_value
    data_point.invert_if_negative = True

    presentation.save("data_point_invert_color_if_negative.pptx", slides.export.SaveFormat.PPTX)

Een specifieke gegevenspuntwaarde wissen

Om één punt leeg te maken zonder de andere punten te verwijderen, stelt u de onderliggende werkboekcel in op None. Voor een kolomdiagram is de weergegeven waarde beschikbaar via ChartDataPoint.value. Het gegevenspunt blijft op dezelfde categorische positie, maar het diagram behandelt de waarde als leeg volgens de instellingen voor lege waarden.

Het volgende voorbeeld wist alleen het tweede punt in de eerste reeks:

import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
first_series_index = 0
target_data_point_index = 1

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.CLUSTERED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[first_series_index]
    data_point = series.data_points[target_data_point_index]
    data_point.value.as_cell.value = None

    presentation.save("clear_data_point_value.pptx", slides.export.SaveFormat.PPTX)

Spreidingsdiagrammen gebruiken aparte X‑ en Y‑cellen, en bubbel­diagrammen gebruiken ook een groottecel. Wis alleen de cel die de waarde vertegenwoordigt die u wilt verwijderen. Roep ChartDataPointCollection.clear niet aan wanneer u de andere punten wilt behouden, want die methode verwijdert elk gegevenspunt uit de collectie.

Weergave van lege cellen regelen

Verborgen cellen die waarden bevatten vormen een apart geval van lege cellen. Zie Include Data from Hidden Rows and Columns om gegevens van verborgen werkbladrijen en -kolommen op te nemen of uit te sluiten.

Een lege werkboekcel vertegenwoordigt ontbrekende data; een cel met 0 vertegenwoordigt een bekende numerieke waarde. Stel ChartDataCell.value in op None om een cel leeg te maken. Een numerieke nul blijft een nul, ongeacht de instelling voor lege cellen.

Gebruik Chart.display_blanks_as om te kiezen hoe het diagram lege cellen weergeeft. Deze instelling geldt voor het gehele diagram. Hij bepaalt hoe lege waarden worden geplot, zonder de lege werkboekcel te vullen met nul of een geïnterpoleerde waarde.

Het volgende zelfstandige voorbeeld maakt een lijndiagram met één reeks, wist de waarde voor Dag 3, en slaat hetzelfde diagram op met elk modus. Er is geen invoerbestand vereist. De ChartDataWorkbook gebruikt werkblad 0, kolom 0 voor categorielabels, en kolom 1 voor waarden; rij 0 bevat de reeksnaam. De uiteindelijke data is 10, 20, empty, 30, 40.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.LINE_WITH_MARKERS, 40, 40, 640, 400)
    chart_data = chart.chart_data
    workbook = chart_data.chart_data_workbook

    chart_data.series.clear()
    chart_data.categories.clear()

    series_name_cell = workbook.get_cell(0, 0, 1, "Measurements")
    series = chart_data.series.add(series_name_cell, chart.type)
    values = [10, 20, 25, 30, 40]

    for i, value in enumerate(values):
        category_cell = workbook.get_cell(0, i + 1, 0, f"Day {i + 1}")
        chart_data.categories.add(category_cell)
        value_cell = workbook.get_cell(0, i + 1, 1, value)
        series.data_points.add_data_point_for_line_series(value_cell)

    # Laat Dag 3 echt leeg, terwijl de categorie en het gegevenspunt behouden blijven.
    workbook.get_cell(0, 3, 1).value = None

    modes = [("Gap", charts.DisplayBlanksAsType.GAP), ("Zero", charts.DisplayBlanksAsType.ZERO), ("Span", charts.DisplayBlanksAsType.SPAN)]
    for mode_name, mode in modes:
        chart.display_blanks_as = mode
        presentation.save(f"empty_cells_{mode_name}.pptx", slides.export.SaveFormat.PPTX)

Elk uitvoerbestand slaat de vóór het opslaan ingestelde modus op: empty_cells_Gap.pptx, empty_cells_Zero.pptx en empty_cells_Span.pptx. Om slechts één versie op te slaan, stelt u de gewenste modus in en slaat de presentatie één keer op in plaats van over de modi te itereren.

De vergelijking hieronder toont dezelfde data in alle drie de bestanden. Dag 3 is in elk geval leeg in het werkboek:

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.

Het zichtbare effect hangt af van het diagramtype. Een lijndiagram maakt alle drie de modi gemakkelijk vergelijkbaar. Balk‑ en kolomdiagrammen hebben geen lijn om over een ontbrekende categorie te verbinden, dus SPAN kan niet het verbindingssegment produceren dat hierboven wordt getoond; een ontbrekende kolom en een kolom met nulhoogte kunnen er ook op lijken. Evenzo heeft een spreidingsdiagram met alleen markeringen geen verbindingslijn. Verwacht geen drie verschillende resultaten voor elk diagramtype; controleer de output voor het type dat u gebruikt.

Gatbreedte van de reeks instellen

Gatbreedte is de ruimte tussen aangrenzende balk‑ of kolomclusters, uitgedrukt als een percentage van de breedte van de balk of kolom. Net als overlap behoort hij tot de bovenliggende reeks‑groep in plaats van tot één reeks. Stel ChartSeriesGroup.gap_width eenmaal in voor de groep. Een grotere waarde creëert meer ruimte tussen clusters; een kleinere waarde maakt ze dichter.

Het volgende voorbeeld wijzigt de gatbreedte en slaat alleen de uiteindelijke presentatie op:

import aspose.slides as slides
import aspose.slides.charts as charts

first_slide_index = 0
first_series_index = 0
gap_width_percent = 30

with slides.Presentation() as presentation:
    slide = presentation.slides[first_slide_index]

    chart = slide.shapes.add_chart(charts.ChartType.STACKED_COLUMN, 20, 20, 500, 200)

    series = chart.chart_data.series[first_series_index]
    series.parent_series_group.gap_width = gap_width_percent

    presentation.save("gap_width_30.pptx", slides.export.SaveFormat.PPTX)

Resultaat:

The gap width

Reeks‑lijnen weergeven of verbergen

Reeks‑lijnen verbinden visueel gerelateerde delen van een diagram. Gebruik ChartSeriesGroup.has_series_lines om ze in ondersteunde gestapelde balk‑ en OfPie‑diagrammen weer te geven of te verbergen. In tweedimensionale gestapelde balk‑ en kolomdiagrammen verbinden ze overeenkomstige stapelgrenzen over categorieën. In Pie of Pie‑ en Bar of Pie‑diagrammen verbinden ze de hoofdplot met de secundaire plot. Deze instelling is geen algemene connector voor andere diagramtypen.

Benader de groep via ChartSeries.parent_series_group. De instelling geldt voor elke reeks in die groep. ChartSeries.has_series_lines is alleen‑lezen en geeft de instelling van de bovenliggende groep weer; wijzig de groepseigenschap om deze bij te werken.

Het volgende voorbeeld maakt één ChartType.PIE_OF_PIE‑diagram met standaarddata. Het slaat hetzelfde diagram op met reeks‑lijnen ingeschakeld en vervolgens uitgeschakeld, waardoor twee presentaties voor vergelijking ontstaan.

import aspose.slides as slides
import aspose.slides.charts as charts

with slides.Presentation() as presentation:
    slide = presentation.slides[0]

    chart = slide.shapes.add_chart(charts.ChartType.PIE_OF_PIE, 50, 50, 600, 400)
    series = chart.chart_data.series[0]
    series_group = series.parent_series_group

    series_group.has_series_lines = True
    presentation.save("series_lines_enabled.pptx", slides.export.SaveFormat.PPTX)

    series_group.has_series_lines = False
    presentation.save("series_lines_disabled.pptx", slides.export.SaveFormat.PPTX)
Reeks‑lijnen ingeschakeld Reeks‑lijnen uitgeschakeld
Pie of Pie chart with series lines enabled Pie of Pie chart with series lines disabled
De twee lijnen verbinden de hoofd‑pie met de secundaire pie. Beide pies blijven zichtbaar, maar de verbindingslijnen zijn verborgen.

Reeks‑lijnen verschillen van leidings‑lijnen van gegevenslabels, die labels met hun gegevenspunten verbinden; van rasterlijnen, die intervallen langs de as markeren; en van de lijnen in een lijndiagram, die gegevenswaarden weergeven. Deze instelling regelt die elementen niet.

FAQ

Welke diagramtypen ondersteunen gegevensreeksen?

Alle diagramtypen die worden vertegenwoordigd door de ChartType‑enumeratie gebruiken diagramdata, maar hun reeksen hebben niet allemaal dezelfde waardestructuur of instellingen. Bijvoorbeeld, categorische diagrammen gebruiken categorieën en waarden, spreidingsdiagrammen gebruiken X‑ en Y‑waarden, en bubbel‑diagrammen voegen bubbelgroottes toe. Gebruik de gegevenspunt‑creatiemethode die overeenkomt met het reekstype. Opties zoals overlap en gatbreedte gelden alleen voor compatibele balk‑ of kolomgroepen.

Wat is een diagramreeks‑groep?

Een ChartSeriesGroup bevat compatibele reeksen die groeps‑level plotinstellingen delen. Een combinatie‑diagram kan meer dan één groep bevatten, zodat het wijzigen van de groep verkregen via één reeks niet per‑se elke reeks in het diagram verandert.

Bevat een nieuw aangemaakt diagram standaarddata?

Ja. Standaard maakt ShapeCollection.add_chart voorbeeldreeksen, categorieën en waarden aan. U kunt die cellen bewerken of zowel de reeks‑ als de categorieverzamelingen wissen voordat u een volledig aangepaste dataset toevoegt. Een overload kan ook een diagram zonder standaarddata aanmaken.

Hoe zijn diagramobjecten gekoppeld aan werkboekcellen?

Reeksnamen, categorielabels en gegevenspuntwaarden verwijzen naar cellen in een ChartDataWorkbook. Het wijzigen van een verwezen cel werkt het corresponderende diagramonderdeel bij. Wanneer u aangepaste data bouwt, houdt u de categorierijen en reeksen‑waarde‑rijen op één lijn zodat elk punt onder de bedoelde categorie wordt geplot.

Hoe kan ik één punt wissen in plaats van de hele reeks?

Stel de betreffende waardecel in op None om de positie van het punt in de categorie te behouden als een leeg punt. Gebruik ChartDataPointCollection.clear alleen wanneer u alle punten uit die reeks wilt verwijderen. Als u ook categorieën verwijdert, werk dan elke reeks bij zodat hun waarden blijven overeenstemmen met de categorieverzameling.

Hoe worden lege punten weergegeven?

Het resultaat hangt af van het diagramtype en van Chart.display_blanks_as. Ondersteunde diagrammen kunnen lege waarden tonen als gaten, als nulwaarden, of door naburige punten te verbinden. Kies de instelling die past bij de betekenis van ontbrekende data in uw presentatie. Zie Control the Display of Empty Cells voor een compleet voorbeeld en visuele vergelijking.

Hoe worden negatieve waarden opgemaakt?

Voor ondersteunde balk‑, kolom‑ en bubbelreeksen schakelt u ChartSeries.invert_if_negative in en stelt u ChartSeries.inverted_solid_fill_color in. U kunt het gedrag voor een individueel punt overschrijven met ChartDataPoint.invert_if_negative. Deze eigenschappen beïnvloeden de opmaak, niet de opgeslagen numerieke waarden.

Welke opmaak heeft voorrang wanneer zowel een reeks als een punt zijn opgemaakt?

Expliciete gegevenspunt‑opmaak heeft voorrang voor dat punt. Andere punten blijven de expliciete reeks‑opmaak gebruiken of, wanneer de reeks‑opmaak niet is gedefinieerd, de automatische diagramstijl en het thema. Groepseigenschappen zoals overlap en gatbreedte bepalen de lay‑out en vormen geen punt‑niveau opmaak‑overschrijvingen.

Is er een limiet aan het aantal reeksen dat een diagram kan bevatten?

Aspose.Slides legt geen aparte vaste limiet op voor het aantal reeksen. In de praktijk bepalen bestandsrestricties, beschikbaar geheugen, renderingstijd en leesbaarheid van het diagram een bruikbare limiet.

Wat moet ik aanpassen wanneer kolommen te dicht bij elkaar staan of te ver uit elkaar?

Stel ChartSeriesGroup.gap_width in op de juiste bovenliggende reeks‑groep. Verhoog de waarde om de ruimte tussen clusters te vergroten, of verlaag hem om de clusters dichter bij elkaar te brengen.