ChartDataLabelCollection

ChartDataLabelCollection class

Representerar en samling avChartDataLabel .

För att lära dig mer, besökArbeta med diagram dokumentationsartikel.

public class ChartDataLabelCollection : IEnumerable<ChartDataLabel>

Egenskaper

namnBeskrivning
Count { get; }Returnerar antaletChartDataLabel i den här samlingen.
Font { get; }Ger åtkomst till teckensnittsformateringen för dataetiketterna för hela serien.
Format { get; }Ger åtkomst till fyllnings- och linjeformatering av dataetiketterna.
Item { get; }ReturerChartDataLabel för det angivna indexet.
NumberFormat { get; }Får enChartNumberFormat instans som tillåter att ställa in talformat för dataetiketterna för hela serien .
Orientation { get; set; }Hämtar eller ställer in textorienteringen för dataetiketterna i hela serien.
Position { get; set; }Hämtar eller anger positionen för dataetiketterna.
Rotation { get; set; }Hämtar eller ställer in rotationen av dataetiketterna för hela serien i grader.
Separator { get; set; }Hämtar eller ställer in strängavgränsare som används för dataetiketter för hela serien. Standardvärdet är ett kommatecken, förutom för cirkeldiagram som endast visar kategorinamn och procentandel, då en radbrytning ska användas istället.
ShowBubbleSize { get; set; }Gör det möjligt att ange om bubbelstorleken ska visas för dataetiketterna i hela serien. Gäller endast bubbeldiagram. Standardvärdet ärfalsk .
ShowCategoryName { get; set; }Gör det möjligt att ange om kategorinamnet ska visas för dataetiketterna för hela serien. Standardvärdet ärfalsk .
ShowDataLabelsRange { get; set; }Gör det möjligt att ange om värden från dataetikettintervallet ska visas i dataetiketterna för hela serien. Standardvärdet ärfalsk .
ShowLeaderLines { get; set; }Gör det möjligt att ange om hänvisningslinjer för dataetiketter ska visas för dataetiketterna i hela serien. Standardvärdet ärfalsk .
ShowLegendKey { get; set; }Gör det möjligt att ange om förklaringsnyckeln ska visas för dataetiketterna för hela serien. Standardvärdet ärfalsk .
ShowPercentage { get; set; }Gör det möjligt att ange om procentvärde ska visas för dataetiketterna för hela serien. Standardvärdet ärfalsk Gäller endast cirkeldiagram.
ShowSeriesName { get; set; }Returnerar eller anger ett booleskt värde för att ange visningsbeteendet för serienamnet för dataetiketterna för hela serien. sann för att visa seriens namn;falsk att dölja. Som standardfalsk .
ShowValue { get; set; }Gör det möjligt att ange om värden ska visas i dataetiketterna för hela serien. Standardvärdet ärfalsk .

Metoder

namnBeskrivning
ClearFormat()Rensar formatet för allaChartDataLabel i den här samlingen.
GetEnumerator()Returnerar ett uppräknarobjekt.

Exempel

Visar hur man applicerar etiketter på datapunkter i ett linjediagram.

public void DataLabels()
{
    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);

    // Använd dataetiketter på varje serie i diagrammet.
    // Dessa etiketter visas bredvid varje datapunkt i grafen och visar dess värde.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Ändra avgränsningssträngen för varje dataetikett i en serie.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    ChartDataLabel dataLabel = chart.Series[1].DataLabels[2];
    dataLabel.Format.Fill.Color = Color.Red;

    // För en renare graf kan vi ta bort dataetiketter individuellt.
    dataLabel.ClearFormat();

    // Vi kan också ta bort en hel serie av dess dataetiketter samtidigt.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Använd dataetiketter med anpassat talformat och avgränsare på flera datapunkter i en serie.
/// </summary>
private static void ApplyDataLabels(ChartSeries series, int labelsCount, string numberFormat, string separator)
{
    series.HasDataLabels = true;
    series.Explosion = 40;

    for (int i = 0; i < labelsCount; i++)
    {
        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;
        Assert.False(series.DataLabels[i].IsHidden);
        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);
    }
}

Se även

ChartDataLabel Class ChartDataLabelLocationMode Enum