Anpassen von Fehlerbalken in Präsentationsdiagrammen in .NET

Fehlerbalken hinzufügen

Aspose.Slides für .NET stellt eine einfache API zur Verwaltung von Fehlerbalkenwerten bereit. 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 einer Serie:

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

     // Hinzufügen von Fehlerbalken und Festlegen des Formats
     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);
 }

Benutzerdefinierte Fehlerbalkenwerte hinzufügen

Aspose.Slides für .NET stellt eine einfache API zur Verwaltung benutzerdefinierter Fehlerbalkenwerte bereit. 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 einer Serie:

  1. Erstellen Sie eine Instanz der Presentation-Klasse.
  2. Fügen Sie auf der gewünschten Folie ein Blasendiagramm hinzu.
  3. Greifen Sie auf die erste Diagrammserie zu und legen Sie das X-Format des Fehlerbalkens fest.
  4. Greifen Sie auf die erste Diagrammserie zu und legen Sie das Y-Format des Fehlerbalkens fest.
  5. Greifen Sie auf die einzelnen Datenpunkte der Diagrammserie zu und setzen Sie die Fehlerbalkenwerte für den jeweiligen Datenpunkt der Serie.
  6. Festlegen von Balkenwerten und -format.
  7. Schreiben Sie die bearbeitete 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);

     // Benutzerdefinierte Fehlerbalken hinzufügen und das 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 Diagrammserie 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 Diagrammserienpunkte 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, wenn eine Präsentation in PDF oder Bilder exportiert wird?

Sie werden als Teil des Diagramms gerendert und bei der Konvertierung zusammen mit der restlichen Diagrammformatierung erhalten, vorausgesetzt, es wird eine kompatible Version oder ein kompatibler Renderer verwendet.

Können Fehlerbalken mit Markierungen und Datenbeschriftungen kombiniert werden?

Ja. Fehlerbalken sind ein separates Element und kompatibel mit Markierungen und Datenbeschriftungen; überlappen sich die Elemente, müssen Sie ggf. die Formatierung anpassen.

Wo finde ich die Liste der Eigenschaften und Aufzählungen zur Arbeit mit Fehlerbalken in der API?

In der API-Referenz: die Klasse ErrorBarsFormat und die zugehörigen Aufzählungen ErrorBarType und ErrorBarValueType.