ChartDataPoint

ChartDataPoint class

Permet de spécifier le formatage d’un seul point de données sur le graphique.

public class ChartDataPoint : IChartDataPoint

Propriétés

Nom La description
Bubble3D { get; set; }
Explosion { get; set; }
Format { get; } Fournit un accès au remplissage et à la mise en forme des lignes de ce point de données.
Index { get; } Index du point de données auquel cet objet applique le formatage.
InvertIfNegative { get; set; }
Marker { get; }

Méthodes

Nom La description
ClearFormat() Efface le format de ce point de données. Les propriétés sont définies sur les valeurs par défaut définies dans la série parent.

Remarques

Sur une série, leChartDataPoint l’objet est membre duChartDataPointCollection . LeChartDataPointCollection contient unChartDataPoint objet pour chaque point.

Exemples

Montre comment travailler avec des points de données sur un graphique en courbes.

[Test]
public void ChartDataPoint()
{
    Document doc = new Document();
    DocumentBuilder builder = new DocumentBuilder(doc);

    Shape shape = builder.InsertChart(ChartType.Line, 500, 350);
    Chart chart = shape.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);

    // Accentue les points de données du graphique en les faisant apparaître sous forme de losanges.
    foreach (ChartSeries series in chart.Series) 
        ApplyDataPoints(series, 4, MarkerSymbol.Diamond, 15);

    // Lisser la ligne qui représente la première série de données.
    chart.Series[0].Smooth = true;

    // Vérifiez que les points de données de la première série n'inverseront pas leurs couleurs si la valeur est négative.
    using (IEnumerator<ChartDataPoint> enumerator = chart.Series[0].DataPoints.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.False(enumerator.Current.InvertIfNegative);
        }
    }

    // Pour un graphique plus propre, nous pouvons effacer le format individuellement.
    chart.Series[1].DataPoints[2].ClearFormat();

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

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

/// <summary>
/// Applique un certain nombre de points de données à une série.
/// </summary>
private static void ApplyDataPoints(ChartSeries series, int dataPointsCount, MarkerSymbol markerSymbol, int dataPointSize)
{
    for (int i = 0; i < dataPointsCount; i++)
    {
        ChartDataPoint point = series.DataPoints[i];
        point.Marker.Symbol = markerSymbol;
        point.Marker.Size = dataPointSize;

        Assert.AreEqual(i, point.Index);
    }
}

Voir également