ChartDataPoint

ChartDataPoint class

Permette di specificare la formattazione di un singolo punto dati sul grafico.

Per saperne di più, visita ilLavorare con i grafici articolo di documentazione.

public class ChartDataPoint : IChartDataPoint

Proprietà

NomeDescrizione
Bubble3D { get; set; }Specifica se alle bolle nel grafico a bolle deve essere applicato un effetto 3D.
Explosion { get; set; }Specifica di quanto il punto dati deve essere spostato dal centro della torta. Può essere negativo, negativo significa che la proprietà non è impostata e non deve essere applicata alcuna esplosione. Si applica solo ai grafici a torta.
Format { get; }Fornisce l’accesso al riempimento e alla formattazione della linea di questo punto dati.
Index { get; }Indice del punto dati a cui questo oggetto applica la formattazione.
InvertIfNegative { get; set; }Specifica se l’elemento genitore deve invertire i suoi colori se il valore è negativo.
Marker { get; }Specifica l’indicatore dei dati del grafico.

Metodi

NomeDescrizione
ClearFormat()Cancella il formato di questo punto dati. Le proprietà vengono impostate sui valori predefiniti definiti nella serie principale.

Osservazioni

In una serie, ilChartDataPoint l’oggetto è un membro diChartDataPointCollection . IlChartDataPointCollection contiene unChartDataPoint oggetto per ogni punto.

Esempi

Mostra come utilizzare i punti dati su un grafico a linee.

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

    // Enfatizza i punti dati del grafico facendoli apparire come forme di diamante.
    foreach (ChartSeries series in chart.Series) 
        ApplyDataPoints(series, 4, MarkerSymbol.Diamond, 15);

    // Appianare la linea che rappresenta la prima serie di dati.
    chart.Series[0].Smooth = true;

    // Verifica che i punti dati per la prima serie non invertano i colori se il valore è negativo.
    using (IEnumerator<ChartDataPoint> enumerator = chart.Series[0].DataPoints.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.False(enumerator.Current.InvertIfNegative);
        }
    }

    // Per un grafico dall'aspetto più pulito, possiamo cancellare il formato individualmente.
    chart.Series[1].DataPoints[2].ClearFormat();

    // Possiamo anche eliminare un'intera serie di punti dati contemporaneamente.
    chart.Series[2].DataPoints.ClearFormat();

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

/// <summary>
/// Applica un numero di punti dati 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);
    }
}

Guarda anche