Gérer les séries de données de graphique dans les présentations en .NET
Vue d’ensemble
Cet article décrit le rôle de ChartSeries dans Aspose.Slides pour .NET, en se concentrant sur la manière dont les données sont structurées et visualisées dans les présentations. Ces objets fournissent les éléments fondamentaux qui définissent les ensembles individuels de points de données, les catégories et les paramètres d’apparence d’un graphique. En travaillant avec ChartSeries, les développeurs peuvent intégrer facilement les sources de données sous‑jacentes et garder un contrôle total sur la façon dont l’information est affichée, ce qui donne des présentations dynamiques, axées sur les données, qui transmettent clairement les insights et les analyses.
Une série est une ligne ou une colonne de nombres tracés dans un graphique.
Définir le chevauchement des séries de graphique
La propriété IChartSeriesOverlap contrôle la façon dont les barres et les colonnes se chevauchent dans un graphique 2D en spécifiant une plage de -100 à 100. Puisque cette propriété est associée au groupe de séries plutôt qu’à une série individuelle, elle est en lecture seule au niveau de la série. Pour configurer les valeurs de chevauchement, utilisez la propriété en lecture/écriture ParentSeriesGroup.Overlap, qui applique le chevauchement spécifié à toutes les séries du groupe.
Voici un exemple C# qui montre comment créer une présentation, ajouter un graphique à colonnes groupées, accéder à la première série de graphique, configurer le paramètre de chevauchement, puis enregistrer le résultat au format PPTX :
sbyte overlap = 30;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Ajouter un graphique à colonnes groupées avec les données par défaut.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
IChartSeries series = chart.ChartData.Series[0];
if (series.Overlap == 0)
{
// Définir le chevauchement des séries.
series.ParentSeriesGroup.Overlap = overlap;
}
// Enregistrer le fichier de présentation sur le disque.
presentation.Save("series_overlap.pptx", SaveFormat.Pptx);
}
Le résultat :
Modifier la couleur de remplissage de la série
Aspose.Slides simplifie la personnalisation des couleurs de remplissage des séries de graphique, vous permettant de mettre en évidence des points de données spécifiques et de créer des graphiques visuellement attrayants. Cela est réalisé via l’objet IFormat, qui prend en charge différents types de remplissage, configurations de couleur et autres options de style avancées. Après avoir ajouté un graphique à une diapositive et accédé à la série souhaitée, récupérez simplement la série et appliquez la couleur de remplissage appropriée. Au‑delà des remplissages unis, vous pouvez également exploiter les remplissages en dégradé ou en motif pour plus de flexibilité de conception. Une fois les couleurs définies selon vos besoins, enregistrez la présentation pour finaliser le rendu mis à jour.
L’exemple de code C# suivant montre comment changer la couleur de la première série :
Color seriesColor = Color.Blue;
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Ajouter un graphique à colonnes groupées avec les données par défaut.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
// Définir la couleur de la première série.
IChartSeries series = chart.ChartData.Series[0];
series.Format.Fill.FillType = FillType.Solid;
series.Format.Fill.SolidFillColor.Color = seriesColor;
// Enregistrer le fichier de présentation sur le disque.
presentation.Save("series_color.pptx", SaveFormat.Pptx);
}
Le résultat :
Modifier le nom de la série
Aspose.Slides offre un moyen simple de modifier les noms des séries de graphique, facilitant l’étiquetage des données de façon claire et significative. En accédant à la cellule de feuille de calcul correspondante dans les données du graphique, les développeurs peuvent personnaliser la présentation des données. Cette modification est particulièrement utile lorsque les noms des séries doivent être actualisés ou clarifiés en fonction du contexte des données. Après avoir renommé la série, la présentation peut être enregistrée pour conserver les changements.
Voici un extrait de code C# illustrant ce processus en action.
string seriesName = "New name";
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Ajouter un graphique à colonnes groupées avec les données par défaut.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
// Définir le nom de la première série.
IChartDataCell seriesCell = chart.ChartData.ChartDataWorkbook.GetCell(0, 0, 1);
seriesCell.Value = seriesName;
// Enregistrer le fichier de présentation sur le disque.
presentation.Save("series_name.pptx", SaveFormat.Pptx);
}
L’extrait de code C# suivant montre une autre façon de changer le nom de la série :
string seriesName = "New name";
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Ajouter un graphique à colonnes groupées avec les données par défaut.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
// Définir le nom de la première série.
IChartSeries series = chart.ChartData.Series[0];
series.Name.AsCells[0].Value = seriesName;
// Enregistrer le fichier de présentation sur le disque.
presentation.Save("series_name.pptx", SaveFormat.Pptx);
}
Le résultat :
Obtenir la couleur de remplissage automatique de la série
Aspose.Slides pour .NET vous permet d’obtenir la couleur de remplissage automatique des séries de graphique dans une zone de tracé. Après avoir créé une instance de la classe Presentation, vous pouvez obtenir une référence à la diapositive souhaitée par index, puis ajouter un graphique en utilisant le type de votre choix (par exemple ChartType.ClusteredColumn). En accédant aux séries du graphique, vous pouvez récupérer la couleur de remplissage automatique.
Le code C# ci‑dessous détaille ce processus.
using (Presentation presentation = new Presentation())
{
ISlide slide = presentation.Slides[0];
// Ajouter un graphique à colonnes groupées avec les données par défaut.
IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn, 20, 20, 500, 200);
for (int i = 0; i < chart.ChartData.Series.Count; i++)
{
// Obtenir la couleur de remplissage de la série.
Color color = chart.ChartData.Series[i].GetAutomaticSeriesColor();
Console.WriteLine($"Series {i} color: {color.Name}");
}
}
Sortie :
Series 0 color: ff4f81bd
Series 1 color: ffc0504d
Series 2 color: ff9bbb59
Définir la couleur de remplissage inversée pour une série de graphique
Lorsque votre série de données contient à la fois des valeurs positives et négatives, appliquer la même couleur à chaque colonne ou barre peut rendre le graphique difficile à lire. Aspose.Slides pour .NET vous permet d’attribuer une couleur de remplissage inversée — un remplissage distinct appliqué automatiquement aux points de données situés en dessous de zéro—de sorte que les valeurs négatives se démarquent immédiatement. Dans cette section, vous apprendrez comment activer cette option, choisir une couleur appropriée et enregistrer la présentation mise à jour.
L’exemple de code suivant montre l’opération :
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();
// Ajouter de nouvelles catégories.
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"));
// Ajouter une nouvelle série.
IChartSeries series = chart.ChartData.Series.Add(workBook.GetCell(0, 0, 1, "Series 1"), chart.Type);
// Remplir les données de la série.
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));
// Définir les paramètres de couleur pour la série.
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);
}
Le résultat :
Vous pouvez inverser la couleur de remplissage pour un seul point de données plutôt que pour l’ensemble de la série. Accédez simplement au IChartDataPoint souhaité et définissez sa propriété InvertIfNegative sur true.
L’exemple de code suivant montre comment faire cela :
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));
// Inverser la couleur si le point de données à l'index 2 est négatif.
series.InvertIfNegative = false;
series.DataPoints[2].InvertIfNegative = true;
presentation.Save("data_point_invert_color_if_negative.pptx", SaveFormat.Pptx);
}
Effacer les valeurs de points de données spécifiques
Parfois, un graphique contient des valeurs de test, des valeurs aberrantes ou des entrées obsolètes que vous devez supprimer sans reconstruire toute la série. Aspose.Slides pour .NET vous permet de cibler n’importe quel point de données par son index, de vider son contenu et d’actualiser instantanément le tracé afin que les points restants se repositionnent et que les axes se redimensionnent automatiquement.
L’exemple de code suivant illustre l’opération :
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);
}
Définir la largeur de l’écart de la série
La largeur d’écart contrôle la quantité d’espace vide entre les colonnes ou barres adjacentes — des écarts plus larges mettent en avant les catégories individuelles, tandis que des écarts plus étroits créent un aspect plus dense et compact. Grâce à Aspose.Slides pour .NET, vous pouvez régler précisément ce paramètre pour une série entière, obtenant ainsi l’équilibre visuel souhaité dans votre présentation sans modifier les données sous‑jacentes.
L’exemple de code suivant montre comment définir la largeur d’écart pour une série :
ushort gapWidth = 30;
// Créer une présentation vide.
using (Presentation presentation = new Presentation())
{
// Accéder à la première diapositive.
ISlide slide = presentation.Slides[0];
// Ajouter un graphique avec les données par défaut.
IChart chart = slide.Shapes.AddChart(ChartType.StackedColumn, 20, 20, 500, 200);
// Enregistrer la présentation sur le disque.
presentation.Save("default_gap_width.pptx", SaveFormat.Pptx);
// Définir la valeur de GapWidth.
IChartSeries series = chart.ChartData.Series[0];
series.ParentSeriesGroup.GapWidth = gapWidth;
// Enregistrer la présentation sur le disque.
presentation.Save("gap_width_30.pptx", SaveFormat.Pptx);
}
Le résultat :
FAQ
Existe‑t‑il une limite au nombre de séries qu’un seul graphique peut contenir ?
Aspose.Slides n’impose aucune limite fixe au nombre de séries que vous ajoutez. Le plafond pratique est déterminé par la lisibilité du graphique et la mémoire disponible pour votre application.
Que faire si les colonnes d’un groupe sont trop proches ou trop éloignées les unes des autres ?
Ajustez le paramètre GapWidth pour cette série (ou son groupe de séries parent). Augmenter la valeur élargit l’espace entre les colonnes, tandis que la diminuer les rapproche.