ChartDataLabelCollection

ChartDataLabelCollection class

Stellt eine Sammlung vonChartDataLabel .

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

public class ChartDataLabelCollection : IEnumerable<ChartDataLabel>

Eigenschaften

Name	Beschreibung
Count { get; }	Gibt die Anzahl der`ChartDataLabel` in dieser Sammlung.
Font { get; }	Bietet Zugriff auf die Schriftformatierung der Datenbeschriftungen der gesamten Serie.
Format { get; }	Bietet Zugriff auf die Füll- und Linienformatierung der Datenbeschriftungen.
Item { get; }	Rückgaben`ChartDataLabel` für den angegebenen Index.
NumberFormat { get; }	Erhält eine`ChartNumberFormat` Instanz, die das Festlegen des Zahlenformats für die Datenbeschriftungen der gesamten Serie ermöglicht.
Orientation { get; set; }	Ruft die Textausrichtung der Datenbeschriftungen der gesamten Reihe ab oder legt sie fest.
Position { get; set; }	Ruft die Position der Datenbeschriftungen ab oder legt sie fest.
Rotation { get; set; }	Ruft die Drehung der Datenbeschriftungen der gesamten Reihe in Grad ab oder legt sie fest.
Separator { get; set; }	Ruft das für die Datenbeschriftungen der gesamten Reihe verwendete Zeichenfolgentrennzeichen ab oder legt es fest. Der Standardwert ist ein Komma, außer bei Kreisdiagrammen, die nur den Kategorienamen und den Prozentsatz anzeigen, bei denen stattdessen ein Zeilenumbruch verwendet werden soll.
ShowBubbleSize { get; set; }	Ermöglicht die Angabe, ob die Blasengröße für die Datenbeschriftungen der gesamten Reihe angezeigt werden soll. Gilt nur für Blasendiagramme. Der Standardwert ist`FALSCH` .
ShowCategoryName { get; set; }	Ermöglicht die Angabe, ob der Kategoriename für die Datenbeschriftungen der gesamten Serie angezeigt werden soll. Der Standardwert ist`FALSCH` .
ShowDataLabelsRange { get; set; }	Ermöglicht die Angabe, ob Werte aus dem Datenbeschriftungsbereich in den Datenbeschriftungen der gesamten Reihe angezeigt werden sollen. Der Standardwert ist`FALSCH` .
ShowLeaderLines { get; set; }	Ermöglicht die Angabe, ob Führungslinien für die Datenbeschriftungen der gesamten Reihe angezeigt werden sollen. Der Standardwert ist`FALSCH` .
ShowLegendKey { get; set; }	Ermöglicht die Angabe, ob der Legendenschlüssel für die Datenbeschriftungen der gesamten Serie angezeigt werden soll. Der Standardwert ist`FALSCH` .
ShowPercentage { get; set; }	Ermöglicht die Angabe, ob der Prozentwert für die Datenbeschriftungen der gesamten Reihe angezeigt werden soll. Der Standardwert ist`FALSCH` . Gilt nur für Kreisdiagramme.
ShowSeriesName { get; set; }	Gibt einen Booleschen Wert zurück oder legt ihn fest, um das Anzeigeverhalten des Seriennamens für die Datenbeschriftungen der gesamten Serie anzugeben. `WAHR` um den Seriennamen anzuzeigen;`FALSCH` zu verbergen. Standardmäßig`FALSCH` .
ShowValue { get; set; }	Ermöglicht die Angabe, ob Werte in den Datenbeschriftungen der gesamten Reihe angezeigt werden sollen. Der Standardwert ist`FALSCH` .

Methoden

Name	Beschreibung
ClearFormat()	Löscht das Format aller`ChartDataLabel` in dieser Sammlung.
GetEnumerator()	Gibt ein Enumeratorobjekt zurück.

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

ChartDataLabel Class ChartDataLabelLocationMode Enum