ChartDataLabelCollection

ChartDataLabelCollection class

Rappresenta una raccolta diChartDataLabel .

public class ChartDataLabelCollection : IEnumerable<ChartDataLabel>

Proprietà

Nome Descrizione
Count { get; } Restituisce il numero diChartDataLabel in questa raccolta.
Item { get; } RestituisceChartDataLabel per l’indice specificato.
NumberFormat { get; } Ottiene unChartNumberFormat istanza che consente di impostare il formato numerico per le etichette dati dell’intera serie .
Separator { get; set; } Ottiene o imposta il separatore di stringa utilizzato per le etichette dati dell’intera serie. L’impostazione predefinita è una virgola, ad eccezione dei grafici a torta che mostrano solo il nome della categoria e la percentuale, quando deve essere utilizzata un’interruzione di riga .
ShowBubbleSize { get; set; } Consente di specificare se la dimensione della bolla deve essere visualizzata per le etichette dati dell’intera serie. Si applica solo ai grafici a bolle. Il valore predefinito è falso .
ShowCategoryName { get; set; } Consente di specificare se il nome della categoria deve essere visualizzato per le etichette dati dell’intera serie. Il valore predefinito è falso .
ShowDataLabelsRange { get; set; } Consente di specificare se i valori dell’intervallo etichette dati devono essere visualizzati nelle etichette dati dell’intera serie. Il valore predefinito è falso .
ShowLeaderLines { get; set; } Consente di specificare se devono essere visualizzate le linee guida dell’etichetta dati per le etichette dati dell’intera serie. Il valore predefinito è falso .
ShowLegendKey { get; set; } Consente di specificare se visualizzare la chiave legenda per le etichette dati dell’intera serie. Il valore predefinito è falso .
ShowPercentage { get; set; } Consente di specificare se il valore percentuale deve essere visualizzato per le etichette dati dell’intera serie. Il valore di default è falso . Si applica solo ai grafici a torta.
ShowSeriesName { get; set; } Restituisce o imposta un valore booleano per indicare il comportamento di visualizzazione del nome della serie per le etichette dei dati dell’intera serie. Veroper mostrare il nome della serie. Falso nascondere. Per impostazione predefinita falso .
ShowValue { get; set; } Consente di specificare se i valori devono essere visualizzati nelle etichette dati dell’intera serie. Il valore predefinito è falso .

Metodi

Nome Descrizione
ClearFormat() Cancella tutto il formatoChartDataLabel in questa raccolta.
GetEnumerator() Restituisce un oggetto enumeratore.

Esempi

Mostra come applicare etichette ai punti dati in un grafico a linee.

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

    // Applica etichette dati a ogni serie nel grafico.
    // Queste etichette appariranno accanto a ciascun punto dati nel grafico e ne visualizzeranno il valore.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Modifica la stringa di separazione per ogni etichetta di dati in una serie.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    // Per un grafico dall'aspetto più pulito, possiamo rimuovere le etichette dei dati individualmente.
    chart.Series[1].DataLabels[2].ClearFormat();

    // Possiamo anche rimuovere un'intera serie di etichette dati contemporaneamente.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Applica etichette dati con formato numerico personalizzato e separatore a più punti dati di una serie.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    for (int i = 0; i < labelsCount; i++)
    {
        series.HasDataLabels = true;

        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;
        series.DataLabels[i].IsHidden = false;
        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);
    }
}

Guarda anche