ChartDataPoint

ChartDataPoint class

Permite especificar el formato de un único punto de datos en el gráfico.

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

public class ChartDataPoint : IChartDataPoint

Propiedades

NombreDescripción
Bubble3D { get; set; }Especifica si las burbujas en el gráfico de burbujas deben tener aplicado un efecto 3D.
Explosion { get; set; }Especifica la cantidad que se moverá el punto de datos desde el centro del pastel. Puede ser negativo, negativo significa que la propiedad no está establecida y no se debe aplicar ninguna explosión. Se aplica solo a gráficos circulares.
Format { get; }Proporciona acceso al formato de relleno y línea de este punto de datos.
Index { get; }Índice del punto de datos al que este objeto aplica formato.
InvertIfNegative { get; set; }Especifica si el elemento principal invertirá sus colores si el valor es negativo.
Marker { get; }Especifica el marcador de datos del gráfico.

Métodos

NombreDescripción
ClearFormat()Borra el formato de este punto de datos. Las propiedades se establecen en los valores predeterminados definidos en la serie principal.

Observaciones

En una serie, elChartDataPoint El objeto es miembro delChartDataPointCollection . ElChartDataPointCollection contiene unaChartDataPoint objeto para cada punto.

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 diamantes.
    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);
        }
    }

    // Para obtener un gráfico más limpio, podemos borrar el formato individualmente.
    chart.Series[1].DataPoints[2].ClearFormat();

    // También podemos eliminar una serie completa 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

ChartDataLabelCollection Class ChartDataPointCollection Class