Gestire le serie di dati dei grafici nelle presentazioni in .NET
Panoramica
Questo articolo descrive il ruolo di ChartSeries in Aspose.Slides per .NET, concentrandosi su come i dati sono strutturati e visualizzati nelle presentazioni. Questi oggetti forniscono gli elementi fondamentali che definiscono insiemi individuali di punti dati, categorie e parametri di aspetto in un grafico. Lavorando con ChartSeries, gli sviluppatori possono integrare senza sforzo le fonti dati sottostanti e mantenere il pieno controllo su come le informazioni sono visualizzate, ottenendo presentazioni dinamiche basate sui dati che comunicano chiaramente approfondimenti e analisi.
Una serie è una riga o colonna di numeri tracciata in un grafico.
Imposta la Sovrapposizione della Serie del Grafico
La proprietà IChartSeriesOverlap controlla come barre e colonne si sovrappongono in un grafico 2D specificando un intervallo da -100 a 100. Poiché questa proprietà è associata al gruppo di serie piuttosto che a una singola serie del grafico, è di sola lettura a livello di serie. Per configurare i valori di sovrapposizione, utilizzare la proprietà ParentSeriesGroup.Overlap in lettura/scrittura, che applica la sovrapposizione specificata a tutte le serie in quel gruppo.
Di seguito è riportato un esempio C# che mostra come creare una presentazione, aggiungere un grafico a colonne raggruppate, accedere alla prima serie del grafico, configurare l’impostazione di sovrapposizione e quindi salvare il risultato come file PPTX:
sbyte overlap = 30;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Aggiungi un grafico a colonne raggruppate con dati predefiniti.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.ChartData.Series[0];
if (series.Overlap == 0)
{
// Imposta la sovrapposizione della serie.
series.ParentSeriesGroup.Overlap = overlap;
}
// Salva il file della presentazione su disco.
presentation.Save("series_overlap.pptx", SaveFormat.Pptx);
}
Il risultato:
Modifica il Colore di Riempimento della Serie
Aspose.Slides rende semplice personalizzare i colori di riempimento delle serie di un grafico, consentendo di evidenziare punti dati specifici e creare grafici visivamente accattivanti. Questo è ottenuto tramite l’oggetto IFormat, che supporta vari tipi di riempimento, configurazioni di colore e altre opzioni di stile avanzate. Dopo aver aggiunto un grafico a una diapositiva e aver accesso alla serie desiderata, basta ottenere la serie e applicare il colore di riempimento appropriato. Oltre ai riempimenti solidi, è possibile utilizzare riempimenti a gradiente o a motivo per una maggiore flessibilità di design. Una volta impostati i colori secondo le proprie esigenze, salvare la presentazione per finalizzare l’aspetto aggiornato.
Il seguente esempio di codice C# mostra come cambiare il colore della prima serie:
Color seriesColor = Color.Blue;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Aggiungi un grafico a colonne raggruppate con dati predefiniti.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
// Imposta il colore della prima serie.
IChartSeries series = chart.ChartData.Series[0];
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = seriesColor;
// Salva il file della presentazione su disco.
presentation.Save("series_color.pptx", SaveFormat.Pptx);
}
Il risultato:
Modifica il Nome della Serie
Aspose.Slides offre un modo semplice per modificare i nomi delle serie di un grafico, facilitando l’etichettatura dei dati in maniera chiara e significativa. Accedendo alla cella del foglio di lavoro pertinente nei dati del grafico, gli sviluppatori possono personalizzare la presentazione dei dati. Questa modifica è particolarmente utile quando è necessario aggiornare o chiarire i nomi delle serie in base al contesto dei dati. Dopo aver rinominato la serie, la presentazione può essere salvata per rendere permanenti le modifiche.
Di seguito è riportato uno snippet di codice C# che dimostra questo processo in azione.
string seriesName = "New name";
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Aggiungi un grafico a colonne raggruppate con dati predefiniti.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
// Imposta il nome della prima serie.
IChartDataCell seriesCell = chart.ChartData.ChartDataWorkbook.GetCell(0, 0, 1);
seriesCell.Value = seriesName;
// Salva il file della presentazione su disco.
presentation.Save("series_name.pptx", SaveFormat.Pptx);
}
Il seguente codice C# mostra un modo alternativo per cambiare il nome della serie:
string seriesName = "New name";
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Aggiungi un grafico a colonne raggruppate con dati predefiniti.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
// Imposta il nome della prima serie.
IChartSeries series = chart.ChartData.Series[0];
series.Name.AsCells[0].Value = seriesName;
// Salva il file della presentazione su disco.
presentation.Save("series_name.pptx", SaveFormat.Pptx);
}
Il risultato:
Ottieni il Colore di Riempimento Automatico della Serie
Aspose.Slides per .NET consente di ottenere il colore di riempimento automatico per le serie di un grafico all’interno di un’area di tracciamento. Dopo aver creato un’istanza della classe Presentation, è possibile ottenere un riferimento alla diapositiva desiderata per indice, quindi aggiungere un grafico usando il tipo preferito (ad esempio ChartType.ClusteredColumn). Accedendo alle serie del grafico, si può ottenere il colore di riempimento automatico.
Il codice C# seguente dimostra questo processo in dettaglio.
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Aggiungi un grafico a colonne raggruppate con dati predefiniti.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
for (int i = 0; i < chart.ChartData.Series.Count; i++)
{
// Ottieni il colore di riempimento della serie.
Color color = chart.ChartData.Series[i].GetAutomaticSeriesColor();
Console.WriteLine($"Series {i} color: {color.Name}");
}
}
Output:
Series 0 color: ff4f81bd
Series 1 color: ffc0504d
Series 2 color: ff9bbb59
Imposta il Colore di Riempimento Invertito per una Serie di Grafico
Quando la serie di dati contiene sia valori positivi sia negativi, colorare tutte le colonne o barre allo stesso modo può rendere il grafico difficile da leggere. Aspose.Slides per .NET permette di assegnare un colore di riempimento invertito — un riempimento separato applicato automaticamente ai punti dati che risultano al di sotto dello zero — così i valori negativi emergono a colpo d’occhio. In questa sezione imparerai come abilitare questa opzione, scegliere un colore appropriato e salvare la presentazione aggiornata.
Il seguente esempio di codice dimostra l’operazione:
Color inverColor = Color.Red;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartDataWorkbook workBook = chart.ChartData.ChartDataWorkbook;
chart.ChartData.Series.Clear();
chart.ChartData.Categories.Clear();
// Aggiungi nuove categorie.
chart.ChartData.Categories.Add(workBook.GetCell(0, 1, 0, "Category 1"));
chart.ChartData.Categories.Add(workBook.GetCell(0, 2, 0, "Category 2"));
chart.ChartData.Categories.Add(workBook.GetCell(0, 3, 0, "Category 3"));
// Aggiungi una nuova serie.
IChartSeries series = chart.ChartData.Series.Add(workBook.GetCell(0, 0, 1, "Series 1"), chart.Type);
// Popola i dati della serie.
series.DataPoints.AddDataPointForBarSeries(workBook.GetCell(0, 1, 1, -20));
series.DataPoints.AddDataPointForBarSeries(workBook.GetCell(0, 2, 1, 50));
series.DataPoints.AddDataPointForBarSeries(workBook.GetCell(0, 3, 1, -30));
// Imposta le impostazioni di colore per la serie.
var seriesColor = series.GetAutomaticSeriesColor();
series.InvertIfNegative = true;
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = seriesColor;
series.InvertedSolidFillColor.Color = inverColor;
presentation.Save("inverted_solid_fill_color.pptx", SaveFormat.Pptx);
}
Il risultato:
È possibile invertire il colore di riempimento per un singolo punto dati anziché per l’intera serie. Basta accedere al IChartDataPoint desiderato e impostare la proprietà InvertIfNegative su true.
Il seguente esempio di codice mostra come fare:
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200, true);
chart.ChartData.Series.Clear();
IChartSeries series = chart.ChartData.Series.Add(chart.ChartData.ChartDataWorkbook.GetCell(0, "B1"), chart.Type);
series.DataPoints.AddDataPointForBarSeries(chart.ChartData.ChartDataWorkbook.GetCell(0, "B2", -5));
series.DataPoints.AddDataPointForBarSeries(chart.ChartData.ChartDataWorkbook.GetCell(0, "B3", 3));
series.DataPoints.AddDataPointForBarSeries(chart.ChartData.ChartDataWorkbook.GetCell(0, "B4", -3));
series.DataPoints.AddDataPointForBarSeries(chart.ChartData.ChartDataWorkbook.GetCell(0, "B5", 1));
// Inverti il colore se il punto dati all indice 2 è negativo.
series.InvertIfNegative = false;
series.DataPoints[2].InvertIfNegative = true;
presentation.Save("data_point_invert_color_if_negative.pptx", SaveFormat.Pptx);
}
Cancella Valori di Punti Dati Specifici
A volte un grafico contiene valori di prova, outlier o voci obsolete che è necessario rimuovere senza ricostruire l’intera serie. Aspose.Slides per .NET consente di mirare a qualsiasi punto dati per indice, cancellarne il contenuto e aggiornare istantaneamente il tracciato in modo che i punti rimanenti si spostino e gli assi si ridimensionino automaticamente.
Il seguente esempio di codice dimostra l’operazione:
using (Presentation presentation = new Presentation("test_chart.pptx"))
{
ISlide slide = presentation.Slides[0];
IChart chart = (IChart)slide.Shapes[0];
IChartSeries series = chart.ChartData.Series[0];
foreach (IChartDataPoint dataPoint in series.DataPoints)
{
dataPoint.XValue.AsCell.Value = null;
dataPoint.YValue.AsCell.Value = null;
}
series.DataPoints.Clear();
presentation.Save("clear_data_points.pptx", SaveFormat.Pptx);
}
Imposta la Larghezza dello Spazio della Serie
La larghezza dello spazio controlla la quantità di spazio vuoto tra colonne o barre adiacenti — spazi più ampi enfatizzano le singole categorie, mentre spazi più stretti creano un aspetto più denso e compatto. Attraverso Aspose.Slides per .NET è possibile regolare finemente questo parametro per un’intera serie, ottenendo l’equilibrio visivo necessario nella presentazione senza alterare i dati sottostanti.
Il seguente esempio di codice mostra come impostare la larghezza dello spazio per una serie:
ushort gapWidth = 30;
// Crea una presentazione vuota.
using (Presentation presentation = new Presentation())
{
// Accedi alla prima diapositiva.
ISlide slide = presentation.Slides[0];
// Aggiungi un grafico con dati predefiniti.
IChart chart = slide.Shapes.AddChart(ChartType.StackedColumn, 20, 20, 500, 200);
// Salva la presentazione su disco.
presentation.Save("default_gap_width.pptx", SaveFormat.Pptx);
// Imposta il valore GapWidth.
IChartSeries series = chart.ChartData.Series[0];
series.ParentSeriesGroup.GapWidth = gapWidth;
// Salva la presentazione su disco.
presentation.Save("gap_width_30.pptx", SaveFormat.Pptx);
}
Il risultato:
FAQ
Esiste un limite al numero di serie che un singolo grafico può contenere?
Aspose.Slides non impone un limite fisso al numero di serie che si aggiungono. Il limite pratico è determinato dalla leggibilità del grafico e dalla memoria disponibile per l’applicazione.
Cosa succede se le colonne all’interno di un raggruppamento sono troppo vicine o troppo distanti?
Regolare l’impostazione GapWidth per quella serie (o per il suo gruppo di serie genitore). Incrementare il valore allarga lo spazio tra le colonne, mentre diminuire lo valore le avvicina.