ChartDataPointCollection

ChartDataPointCollection class

Representa una colección de unChartDataPoint .

Para obtener más información, visite elTrabajar con gráficos Artículo de documentación.

public class ChartDataPointCollection : IEnumerable<ChartDataPoint>

Propiedades

NombreDescripción
Count { get; }Devuelve el número deChartDataPoint en esta colección.
Item { get; }DevuelveChartDataPoint para el índice especificado.

Métodos

NombreDescripción
ClearFormat()Borra el formato de todosChartDataPoint en esta colección.
CopyFormat(int, int)Copia el formato del punto de datos de origen al punto de datos de destino.
GetEnumerator()Devuelve un objeto enumerador.
HasDefaultFormat(int)Obtiene un indicador que indica si el punto de datos en el índice especificado tiene el formato predeterminado.

Ejemplos

Muestra cómo trabajar con puntos de datos en un gráfico de líneas.

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);

    // Enfatiza los puntos de datos del gráfico haciéndolos aparecer como formas de diamante.
    foreach (ChartSeries series in chart.Series)
        ApplyDataPoints(series, 4, MarkerSymbol.Diamond, 15);

    // Suaviza la línea que representa la primera serie de datos.
    chart.Series[0].Smooth = true;

    // Verifique que los puntos de datos de la primera serie no inviertan sus colores si el valor es negativo.
    using (IEnumerator<ChartDataPoint> enumerator = chart.Series[0].DataPoints.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.False(enumerator.Current.InvertIfNegative);
        }
    }

    ChartDataPoint dataPoint = chart.Series[1].DataPoints[2];
    dataPoint.Format.Fill.Color = Color.Red;

    // Para un gráfico más limpio, podemos borrar el formato individualmente.
    dataPoint.ClearFormat();

    // También podemos eliminar una serie entera de puntos de datos a la vez.
    chart.Series[2].DataPoints.ClearFormat();

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

/// <summary>
/// Aplica una cantidad de puntos de datos a una serie.
/// </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);
    }
}

Ver también

ChartDataPoint Class ChartDataTable Class