Fehlerbalken

Fehlerbalken hinzufügen

Aspose.Slides for .NET bietet eine einfache API zur Verwaltung von Fehlerbalkenwerten. Der Beispielcode gilt, wenn ein benutzerdefinierter Werttyp verwendet wird. Um einen Wert anzugeben, verwenden Sie die ErrorBarCustomValues-Eigenschaft eines bestimmten Datenpunkts in der DataPoints-Sammlung der Serie:

  1. Erstellen Sie eine Instanz der Presentation-Klasse.
  2. Fügen Sie ein Blasendiagramm auf der gewünschten Folie hinzu.
  3. Greifen Sie auf die erste Diagrammreihe zu und setzen Sie das X-Fehlerbalken-Format.
  4. Greifen Sie auf die erste Diagrammreihe zu und setzen Sie das Y-Fehlerbalken-Format.
  5. Festlegen von Balkenwerten und -format.
  6. Schreiben Sie die modifizierte Präsentation in eine PPTX-Datei.
 // Leere Präsentation erstellen
using (Presentation presentation = new Presentation())
{
    // Ein Blasendiagramm erstellen
    IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Fehlerbalken hinzufügen und das Format festlegen
    IErrorBarsFormat errBarX = chart.ChartData.Series[0].ErrorBarsXFormat;
    IErrorBarsFormat errBarY = chart.ChartData.Series[0].ErrorBarsYFormat;
    errBarX.IsVisible = true;
    errBarY.IsVisible = true;
    errBarX.ValueType = ErrorBarValueType.Fixed;
    errBarX.Value = 0.1f;
    errBarY.ValueType = ErrorBarValueType.Percentage;
    errBarY.Value = 5;
    errBarX.Type = ErrorBarType.Plus;
    errBarY.Format.Line.Width = 2;
    errBarX.HasEndCap = true;

    // Präsentation speichern
    presentation.Save("ErrorBars_out.pptx", SaveFormat.Pptx);
}

Benutzerdefinierten Fehlerbalkenwert hinzufügen

Aspose.Slides for .NET bietet eine einfache API zur Verwaltung benutzerdefinierter Fehlerbalkenwerte. Der Beispielcode gilt, wenn die IErrorBarsFormat.ValueType-Eigenschaft den Wert Custom hat. Um einen Wert anzugeben, verwenden Sie die ErrorBarCustomValues-Eigenschaft eines bestimmten Datenpunkts in der DataPoints-Sammlung der Serie:

  1. Erstellen Sie eine Instanz der Presentation-Klasse.
  2. Fügen Sie ein Blasendiagramm auf der gewünschten Folie hinzu.
  3. Greifen Sie auf die erste Diagrammreihe zu und setzen Sie das X-Fehlerbalken-Format.
  4. Greifen Sie auf die erste Diagrammreihe zu und setzen Sie das Y-Fehlerbalken-Format.
  5. Greifen Sie auf die einzelnen Datenpunkte der Diagrammreihe zu und setzen Sie die Fehlerbalkenwerte für den jeweiligen Datenpunkt der Reihe.
  6. Festlegen von Balkenwerten und -format.
  7. Schreiben Sie die modifizierte Präsentation in eine PPTX-Datei.
// Leere Präsentation erstellen
using (Presentation presentation = new Presentation())
{
    // Blasendiagramm erstellen
    IChart chart = presentation.Slides[0].Shapes.AddChart(ChartType.Bubble, 50, 50, 400, 300, true);

    // Benutzerdefinierte Fehlerbalken hinzufügen und ihr Format festlegen
    IChartSeries series = chart.ChartData.Series[0];
    IErrorBarsFormat errBarX = series.ErrorBarsXFormat;
    IErrorBarsFormat errBarY = series.ErrorBarsYFormat;
    errBarX.IsVisible = true;
    errBarY.IsVisible = true;
    errBarX.ValueType = ErrorBarValueType.Custom;
    errBarY.ValueType = ErrorBarValueType.Custom;

    // Zugriff auf Datenpunkt der Diagrammreihe und Festlegen der Fehlerbalkenwerte für einzelnen Punkt
    IChartDataPointCollection points = series.DataPoints;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForXPlusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForXMinusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForYPlusValues = DataSourceType.DoubleLiterals;
    points.DataSourceTypeForErrorBarsCustomValues.DataSourceTypeForYMinusValues = DataSourceType.DoubleLiterals;

    // Fehlerbalken für Punkte der Diagrammreihe festlegen
    for (int i = 0; i < points.Count; i++)
    {
        points[i].ErrorBarsCustomValues.XMinus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.XPlus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.YMinus.AsLiteralDouble = i + 1;
        points[i].ErrorBarsCustomValues.YPlus.AsLiteralDouble = i + 1;
    }

    // Präsentation speichern
    presentation.Save("ErrorBarsCustomValues_out.pptx", SaveFormat.Pptx);
}

FAQ

Was passiert mit Fehlerbalken beim Exportieren einer Präsentation zu PDF oder Bildern?
Sie werden als Teil des Diagramms gerendert und bei der Konvertierung zusammen mit der übrigen Diagrammformatierung beibehalten, vorausgesetzt, es wird eine kompatible Version oder ein kompatibler Renderer verwendet.

Können Fehlerbalken mit Markern und Datenbeschriftungen kombiniert werden?
Ja. Fehlerbalken sind ein separates Element und sind mit Markern und Datenbeschriftungen kompatibel; überschneiden sich die Elemente, muss ggf. die Formatierung angepasst werden.

Wo finde ich die Liste der Eigenschaften und Aufzählungen für die Arbeit mit Fehlerbalken in der API?
In der API‑Referenz: die ErrorBarsFormat-Klasse und die zugehörigen Aufzählungen ErrorBarType und ErrorBarValueType.