ChartDataLabel

ChartDataLabel class

Stellt eine Datenbeschriftung auf einem Diagrammpunkt oder einer Trendlinie dar.

Um mehr zu erfahren, besuchen Sie dieArbeiten mit Diagrammen Dokumentationsartikel.

public class ChartDataLabel

Eigenschaften

NameBeschreibung
Font { get; }Bietet Zugriff auf die Schriftformatierung dieses Datenlabels.
Format { get; }Bietet Zugriff auf die Füll- und Linienformatierung des Datenetiketts.
Index { get; }Gibt den Index des enthaltenen Elements an. Dieser Index bestimmt, auf welche der untergeordneten Sammlungen des übergeordneten Elements dieses Element angewendet wird. Der Standardwert ist 0.
IsHidden { get; set; }Ruft ein Flag ab/setzt es, das angibt, ob dieses Label ausgeblendet ist. Der Standardwert istFALSCH .
IsVisible { get; }RückgabenWAHR wenn dieses Datenlabel etwas anzuzeigen hat.
Left { get; set; }Ruft den Abstand der Datenbeschriftung in Punkten vom linken Rand des Diagramms oder von der durch seinePosition Eigentum, abhängig vom Wert desLeftMode Eigenschaft.
LeftMode { get; set; }Ermittelt oder setzt den Interpretationsmodus desLeft Eigenschaftswert: ob die Position der Datenbeschriftung vom linken Rand des Diagramms oder von der durch seine angegebene Position festgelegt wirdPosition Eigenschaft.
NumberFormat { get; }Gibt das Zahlenformat des übergeordneten Elements zurück.
Orientation { get; set; }Ruft die Ausrichtung des Beschriftungstextes ab oder legt sie fest.
Position { get; set; }Ruft die Position der Datenbeschriftung ab oder legt sie fest.
Rotation { get; set; }Ruft die Drehung des Etiketts in Grad ab oder legt sie fest.
Separator { get; set; }Ruft das für die Datenbeschriftungen in einem Diagramm verwendete Zeichenfolgentrennzeichen ab oder legt es fest. Der Standardwert ist ein Komma, außer bei Kreisdiagrammen, die nur den Kategorienamen und den Prozentsatz anzeigen. In diesen Fällen wird stattdessen ein Zeilenumbruch verwendet.
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. Der Standardwert istFALSCH .
ShowCategoryName { get; set; }Ermöglicht die Angabe, ob der Kategoriename für die Datenbeschriftungen in einem Diagramm angezeigt werden soll. Der Standardwert istFALSCH .
ShowDataLabelsRange { get; set; }Ermöglicht die Angabe, ob Werte aus dem Datenbeschriftungsbereich in den Datenbeschriftungen angezeigt werden sollen. Der Standardwert istFALSCH .
ShowLeaderLines { get; set; }Ermöglicht die Angabe, ob Führungslinien für Datenbeschriftungen angezeigt werden sollen. Der Standardwert istFALSCH .
ShowLegendKey { get; set; }Ermöglicht die Angabe, ob für die Datenbeschriftungen in einem Diagramm ein Legendenschlüssel angezeigt werden soll. Der Standardwert istFALSCH .
ShowPercentage { get; set; }Ermöglicht die Angabe, ob für die Datenbeschriftungen in einem Diagramm ein Prozentwert angezeigt werden soll. Der Standardwert istFALSCH .
ShowSeriesName { get; set; }Gibt einen Booleschen Wert zurück oder legt ihn fest, um das Anzeigeverhalten des Seriennamens für die Datenbeschriftungen in einem Diagramm anzugeben. WAHR um den Seriennamen anzuzeigen;FALSCH zu verbergen. StandardmäßigFALSCH .
ShowValue { get; set; }Ermöglicht die Angabe, ob Werte in den Datenbeschriftungen angezeigt werden sollen. Der Standardwert istFALSCH .
Top { get; set; }Ermittelt oder setzt den Abstand der Datenbeschriftung in Punkten vom oberen Rand des Diagramms oder von der Position , die durch seinePosition Eigentum, abhängig vom Wert desTopMode Eigenschaft.
TopMode { get; set; }Ermittelt oder setzt den Interpretationsmodus desTop Eigenschaftswert: ob die Position der Datenbeschriftung vom oberen Rand des Diagramms oder von der durch seine angegebene Position festgelegt wirdPosition Eigenschaft.

Methoden

NameBeschreibung
ClearFormat()Löscht das Format dieser Datenbeschriftung. Die Eigenschaften werden auf die in der übergeordneten Datenbeschriftungssammlung definierten Standardwerte gesetzt.

Bemerkungen

In einer Serie, dieChartDataLabel Objekt ist ein Mitglied derChartDataLabelCollection . DieChartDataLabelCollection enthält eineChartDataLabel Objekt für jeden Punkt.

Beispiele

Zeigt, wie Datenpunkten in einem Liniendiagramm Beschriftungen zugewiesen werden.

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

    // Datenbeschriftungen auf jede Reihe im Diagramm anwenden.
    // Diese Beschriftungen werden neben jedem Datenpunkt im Diagramm angezeigt und zeigen dessen 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 jede Datenbeschriftung in einer Reihe.
    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 ein übersichtlicheres Diagramm können wir die Datenbeschriftungen einzeln entfernen.
    dataLabel.ClearFormat();

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

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

/// <summary>
/// Wenden Sie Datenbeschriftungen 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)
{
    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);
    }
}

Siehe auch

ChartAxisType Enum ChartDataLabelCollection Class