ChartSeries

ChartSeries class

Représente les propriétés de la série de graphiques.

Pour en savoir plus, visitez leTravailler avec des graphiques article de documentation.

public class ChartSeries : IChartDataPoint

Propriétés

NomLa description
Bubble3D { get; set; }Spécifie si les bulles du graphique à bulles doivent avoir un effet 3D appliqué.
BubbleSizes { get; }Obtient une collection de tailles de bulles pour cette série de graphiques.
DataLabels { get; }Spécifie les paramètres des étiquettes de données pour l’ensemble de la série.
DataPoints { get; }Renvoie une collection d’objets de formatage pour tous les points de données de cette série.
Explosion { get; set; }Spécifie la quantité de déplacement du point de données par rapport au centre du graphique à secteurs. Peut être négatif, ce qui signifie que la propriété n’est pas définie et qu’aucune explosion ne doit être appliquée. S’applique uniquement aux graphiques à secteurs.
Format { get; }Donne accès au remplissage et au formatage des lignes de la série.
HasDataLabels { get; set; }Obtient ou définit un indicateur indiquant si les étiquettes de données sont affichées pour la série.
InvertIfNegative { get; set; }Spécifie si l’élément parent doit inverser ses couleurs si la valeur est négative.
LegendEntry { get; }Obtient une entrée de légende pour cette série de graphiques.
Marker { get; }Spécifie un marqueur de données. Le marqueur est créé automatiquement à la demande.
Name { get; set; }Obtient ou définit le nom de la série. Si le nom n’est pas défini explicitement, il est généré à l’aide de l’index. Par défaut, renvoie la série plus un index basé sur.
SeriesType { get; }Obtient le type de cette série de graphiques.
Smooth { get; set; }Permet de spécifier si la ligne reliant les points du graphique doit être lissée à l’aide de splines Catmull-Rom.
XValues { get; }Obtient une collection de valeurs X pour cette série de graphiques.
YValues { get; }Obtient une collection de valeurs Y pour cette série de graphiques.

Méthodes

NomLa description
Add(ChartXValue)Ajoute la valeur X spécifiée à la série de graphiques. Si la série prend en charge les valeurs Y et les tailles de bulle, elles seront vides pour la valeur X.
Add(ChartXValue, ChartYValue)Ajoute les valeurs X et Y spécifiées à la série de graphiques.
Add(ChartXValue, ChartYValue, double)Ajoute la valeur X, la valeur Y et la taille de la bulle spécifiées à la série de graphiques.
Clear()Supprime toutes les valeurs de données de la série de graphiques. Le format de tous les points de données et étiquettes de données est effacé.
ClearValues()Supprime toutes les valeurs de données de la série de graphiques tout en préservant le format des points de données et des étiquettes de données.
CopyFormatFrom(int)Copie le format de point de données par défaut à partir du point de données avec l’index spécifié.
Insert(int, ChartXValue)Insère la valeur X spécifiée dans la série de graphiques à l’index spécifié. Si la série prend en charge les valeurs Y et les tailles de bulle, elles seront vides pour la valeur X.
Insert(int, ChartXValue, ChartYValue)Insère les valeurs X et Y spécifiées dans la série de graphiques à l’index spécifié.
Insert(int, ChartXValue, ChartYValue, double)Insère la valeur X, la valeur Y et la taille de bulle spécifiées dans la série de graphiques à l’index spécifié.
Remove(int)Supprime la valeur X, la valeur Y et la taille de la bulle, si elles sont prises en charge, de la série de graphiques à l’index spécifié. Le point de données et l’étiquette de données correspondants sont également supprimés.

Exemples

Montre comment appliquer des étiquettes aux points de données dans un graphique linéaire.

public void DataLabels()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    Shape chartShape = builder.InsertChart(ChartType.Line, 400, 300);
    Chart chart = chartShape.Chart;

    Assert.AreEqual(3, chart.Series.Count);
    Assert.AreEqual("Series 1", chart.Series[0].Name);
    Assert.AreEqual("Series 2", chart.Series[1].Name);
    Assert.AreEqual("Series 3", chart.Series[2].Name);

    // Appliquer des étiquettes de données à chaque série du graphique.
    // Ces étiquettes apparaîtront à côté de chaque point de données dans le graphique et afficheront sa valeur.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Modifiez la chaîne de séparation pour chaque étiquette de données d'une série.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    ChartDataLabel dataLabel = chart.Series[1].DataLabels[2];
    dataLabel.Format.Fill.Color = Color.Red;

    // Pour un graphique plus propre, nous pouvons supprimer les étiquettes de données individuellement.
    dataLabel.ClearFormat();

    // Nous pouvons également supprimer une série entière de ses étiquettes de données à la fois.
    chart.Series[2].DataLabels.ClearFormat();

    doc.Save(ArtifactsDir + "Charts.DataLabels.docx");
}

/// <summary>
/// Appliquez des étiquettes de données avec un format numérique personnalisé et un séparateur à plusieurs points de données d'une série.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    series.HasDataLabels = true;
    series.Explosion = 40;

    for (int i = 0; i < labelsCount; i++)
    {
        Assert.False(series.DataLabels[i].IsVisible);

        series.DataLabels[i].ShowCategoryName = true;
        series.DataLabels[i].ShowSeriesName = true;
        series.DataLabels[i].ShowValue = true;
        series.DataLabels[i].ShowLeaderLines = true;
        series.DataLabels[i].ShowLegendKey = true;
        series.DataLabels[i].ShowPercentage = false;
        Assert.False(series.DataLabels[i].IsHidden);
        Assert.False(series.DataLabels[i].ShowDataLabelsRange);

        series.DataLabels[i].NumberFormat.FormatCode = numberFormat;
        series.DataLabels[i].Separator = separator;

        Assert.False(series.DataLabels[i].ShowDataLabelsRange);
        Assert.True(series.DataLabels[i].IsVisible);
        Assert.False(series.DataLabels[i].IsHidden);
    }
}

Voir également

ChartNumberFormat Class ChartSeriesCollection Class