ChartDataLabel

ChartDataLabel class

Stellt eine Datenbeschriftung auf einem Diagrammpunkt oder einer Trendlinie dar.

public class ChartDataLabel

Eigenschaften

Name Beschreibung
Index { get; } Gibt den Index des enthaltenden Elements an. Dieser Index bestimmt, auf welche der untergeordneten Sammlungen des übergeordneten Elements sich dieses Element bezieht. Der Standardwert ist 0.
IsHidden { get; set; } Ruft/setzt ein Flag, das angibt, ob dieses Label ausgeblendet ist. Der Standardwert ist FALSCH .
IsVisible { get; } Gibt wahr zurück, wenn diese Datenbeschriftung etwas anzuzeigen hat.
NumberFormat { get; } Gibt das Zahlenformat des übergeordneten Elements zurück.
Separator { get; set; } Ermittelt oder legt das Zeichenfolgentrennzeichen fest, das für die Datenbeschriftungen in einem Diagramm verwendet wird. Der Standardwert ist ein Komma, außer bei Tortendiagrammen, die nur den Kategorienamen und den Prozentsatz anzeigen, wenn stattdessen ein Zeilenumbruch verwendet werden soll.
ShowBubbleSize { get; set; } Ermöglicht die Angabe, ob die Blasengröße für die Datenbeschriftungen in einem Diagramm angezeigt werden soll. Gilt nur für Blasendiagramme. Standardwert ist falsch.
ShowCategoryName { get; set; } Ermöglicht die Angabe, ob der Kategoriename für die Datenbeschriftungen in einem Diagramm angezeigt werden soll. Standardwert ist falsch.
ShowDataLabelsRange { get; set; } Ermöglicht die Angabe, ob Werte aus dem Datenbeschriftungsbereich in den Datenbeschriftungen angezeigt werden sollen. Standardwert ist falsch.
ShowLeaderLines { get; set; } Ermöglicht die Angabe, ob Datenbeschriftungs-Führungslinien angezeigt werden müssen. Standardwert ist falsch.
ShowLegendKey { get; set; } Ermöglicht die Angabe, ob der Legendenschlüssel für die Datenbeschriftungen in einem Diagramm angezeigt werden soll. Standardwert ist falsch.
ShowPercentage { get; set; } Ermöglicht die Angabe, ob Prozentwerte für die Datenbeschriftungen in einem Diagramm angezeigt werden sollen. Standardwert ist falsch.
ShowSeriesName { get; set; } Gibt einen booleschen Wert zurück oder legt ihn fest, um das Verhalten der Reihennamenanzeige für die Datenbeschriftungen in einem Diagramm anzugeben. True, um den Seriennamen anzuzeigen. Falsch zu verstecken. Standardmäßig false.
ShowValue { get; set; } Ermöglicht die Angabe, ob Werte in den Datenbeschriftungen angezeigt werden sollen. Standardwert ist falsch.

Methoden

Name Beschreibung
ClearFormat() Löscht das Format dieses Datenlabels. Die Eigenschaften werden auf die Standardwerte gesetzt, die in der übergeordneten Etikettensammlung data definiert sind.

Bemerkungen

Auf einer Reihe, dieChartDataLabel Objekt ist ein Mitglied vonChartDataLabelCollection . DieChartDataLabelCollection enthält einChartDataLabel Objekt für jeden Punkt.

Beispiele

Zeigt, wie Beschriftungen auf Datenpunkte in einem Liniendiagramm angewendet werden.

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

    // Datenbeschriftungen auf jede Reihe im Diagramm anwenden.
    // Diese Beschriftungen erscheinen neben jedem Datenpunkt im Diagramm und zeigen seinen Wert an.
    foreach (ChartSeries series in chart.Series)
    {
        ApplyDataLabels(series, 4, "000.0", ", ");
        Assert.AreEqual(4, series.DataLabels.Count);
    }

    // Ändern Sie die Trennzeichenfolge für jedes Datenlabel in einer Reihe.
    using (IEnumerator<ChartDataLabel> enumerator = chart.Series[0].DataLabels.GetEnumerator())
    {
        while (enumerator.MoveNext())
        {
            Assert.AreEqual(", ", enumerator.Current.Separator);
            enumerator.Current.Separator = " & ";
        }
    }

    // Für ein sauberer aussehendes Diagramm können wir Datenbeschriftungen einzeln entfernen.
    chart.Series[1].DataLabels[2].ClearFormat();

    // Wir können auch eine ganze Reihe ihrer Datenetiketten auf einmal entfernen.
    chart.Series[2].DataLabels.ClearFormat();

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

/// <summary>
/// Wenden Sie Datenetiketten mit benutzerdefiniertem Zahlenformat und Trennzeichen auf mehrere Datenpunkte in einer Reihe an.
/// </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);
    }
}

Siehe auch