Diagramme mit VSTO und Aspose.Slides für .NET erstellen

Übersicht

Dieser Artikel demonstriert, wie man Diagramme in Microsoft PowerPoint‑Präsentationen programmgesteuert mit C# erstellt und anpasst. Mit Aspose.Slides für .NET können Sie die automatische Erzeugung professioneller, datengetriebener Diagramme durchführen, ohne Microsoft Office oder Interop‑Bibliotheken zu benötigen. Die API bietet einen umfangreichen Funktionsumfang zum Erstellen von Säulendiagrammen, Kreisdiagrammen, Liniendiagrammen und mehr – mit voller Kontrolle über Layout, Daten und Darstellung. Ob Sie Berichte, Dashboards oder Geschäfts‑Präsentationen generieren, Aspose.Slides hilft Ihnen, hochwertige Visualisierungen direkt aus Ihren .NET‑Anwendungen bereitzustellen.

VSTO‑Beispiel

Dieses Kapitel zeigt, wie man in einer Microsoft PowerPoint‑Präsentation ein Diagramm mit VSTO (Visual Studio Tools for Office) erstellt. Mit VSTO können Sie programmgesteuert Diagramme erzeugen und anpassen, indem Sie PowerPoint‑ und Excel‑Automatisierung kombinieren. Das bereitgestellte Beispiel veranschaulicht das Hinzufügen eines 3D‑Clustered‑Column‑Diagramms, das Befüllen mit Daten aus einem Excel‑Arbeitsblatt, das Anpassen von Formatierung und Layout sowie das Speichern der fertigen Präsentation – alles aus einer .NET‑Anwendung heraus.

  1. Erstellen Sie eine Instanz einer Microsoft PowerPoint‑Präsentation.
  2. Fügen Sie der Präsentation eine leere Folie hinzu.
  3. Fügen Sie ein 3D‑Clustered‑Column‑Diagramm hinzu und greifen Sie darauf zu.
  4. Erzeugen Sie eine neue Microsoft Excel‑Arbeitsmapp‑Instanz und laden Sie die Diagrammdaten.
  5. Greifen Sie über die Excel‑Arbeitsmapp‑Instanz auf das Diagrammdaten‑Arbeitsblatt zu.
  6. Legen Sie den Diagrammbereich im Arbeitsblatt fest und entfernen Sie Serie 2 und 3 aus dem Diagramm.
  7. Ändern Sie die Diagrammkategorien im Diagrammdaten‑Arbeitsblatt.
  8. Ändern Sie die Daten von Serie 1 im Diagrammdaten‑Arbeitsblatt.
  9. Greifen Sie auf den Diagrammtitel zu und setzen Sie dessen schriftbezogene Eigenschaften.
  10. Greifen Sie auf die Wertachse des Diagramms zu und setzen Sie Haupteinheit, Nebeneinheit, Maximalwert und Minimalwert.
  11. Greifen Sie auf die Tiefen‑(Serien‑)Achse des Diagramms zu und entfernen Sie sie – in diesem Beispiel wird nur eine Serie verwendet.
  12. Setzen Sie die Rotationswinkel des Diagramms in X‑ und Y‑Richtung.
  13. Speichern Sie die Präsentation.
  14. Schließen Sie die Microsoft Excel‑ und PowerPoint‑Instanzen.
EnsurePowerPointIsRunning(true, true);

// Instanziieren Sie ein Folienobjekt.
Microsoft.Office.Interop.PowerPoint.Slide objSlide = null;

// Greifen Sie auf die erste Präsentationsfolie zu.
objSlide = objPres.Slides[1];

// Wählen Sie die erste Folie aus und setzen Sie ihr Layout.
objSlide.Select();
objSlide.Layout = Microsoft.Office.Interop.PowerPoint.PpSlideLayout.ppLayoutBlank;

// Fügen Sie der Folie ein Standarddiagramm hinzu.
objSlide.Shapes.AddChart(Microsoft.Office.Core.XlChartType.xl3DColumn, 20, 30, 400, 300);

// Greifen Sie auf das hinzugefügte Diagramm zu.
Microsoft.Office.Interop.PowerPoint.Chart ppChart = objSlide.Shapes[1].Chart;

// Greifen Sie auf die Diagrammdaten zu.
Microsoft.Office.Interop.PowerPoint.ChartData chartData = ppChart.ChartData;

// Erstellen Sie eine Instanz der Excel-Arbeitsmappe, um mit den Diagrammdaten zu arbeiten.
Microsoft.Office.Interop.Excel.Workbook dataWorkbook = (Microsoft.Office.Interop.Excel.Workbook)chartData.Workbook;

// Greifen Sie auf das Datenarbeitsblatt des Diagramms zu.
Microsoft.Office.Interop.Excel.Worksheet dataSheet = dataWorkbook.Worksheets[1];

// Setzen Sie den Datenbereich für das Diagramm.
Microsoft.Office.Interop.Excel.Range tRange = dataSheet.Cells.get_Range("A1", "B5");

// Wenden Sie den angegebenen Bereich auf die Diagrammdatentabelle an.
Microsoft.Office.Interop.Excel.ListObject tbl1 = dataSheet.ListObjects["Table1"];
tbl1.Resize(tRange);

// Setzen Sie Werte für Kategorien und zugehörige Seriendaten.
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A2"))).FormulaR1C1 = "Bikes";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A3"))).FormulaR1C1 = "Accessories";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A4"))).FormulaR1C1 = "Repairs";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("A5"))).FormulaR1C1 = "Clothing";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B2"))).FormulaR1C1 = "1000";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B3"))).FormulaR1C1 = "2500";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B4"))).FormulaR1C1 = "4000";
((Microsoft.Office.Interop.Excel.Range)(dataSheet.Cells.get_Range("B5"))).FormulaR1C1 = "3000";

// Setzen Sie den Diagrammtitel.
ppChart.ChartTitle.Font.Italic = true;
ppChart.ChartTitle.Text = "2007 Sales";
ppChart.ChartTitle.Font.Size = 18;
ppChart.ChartTitle.Font.Color = Color.Black.ToArgb();
ppChart.ChartTitle.Format.Line.Visible = Microsoft.Office.Core.MsoTriState.msoTrue;
ppChart.ChartTitle.Format.Line.ForeColor.RGB = Color.Black.ToArgb();

// Greifen Sie auf die Werteachse des Diagramms zu.
Microsoft.Office.Interop.PowerPoint.Axis valaxis = ppChart.Axes(Microsoft.Office.Interop.PowerPoint.XlAxisType.xlValue, Microsoft.Office.Interop.PowerPoint.XlAxisGroup.xlPrimary);

// Setzen Sie die Werte für die Achseneinheiten.
valaxis.MajorUnit = 2000.0F;
valaxis.MinorUnit = 1000.0F;
valaxis.MinimumScale = 0.0F;
valaxis.MaximumScale = 4000.0F;

// Greifen Sie auf die Tiefenachse des Diagramms zu.
Microsoft.Office.Interop.PowerPoint.Axis Depthaxis = ppChart.Axes(Microsoft.Office.Interop.PowerPoint.XlAxisType.xlSeriesAxis, Microsoft.Office.Interop.PowerPoint.XlAxisGroup.xlPrimary);
Depthaxis.Delete();

// Setzen Sie die Diagrammrotation.
ppChart.Rotation = 20;   // Y-Wert
ppChart.Elevation = 15;  // X-Wert
ppChart.RightAngleAxes = false;

// Save the presentation as a PPTX file.
objPres.SaveAs("VSTO_Sample_Chart.pptx", Microsoft.Office.Interop.PowerPoint.PpSaveAsFileType.ppSaveAsDefault, MsoTriState.msoTrue);

// Close the workbook and presentation.
dataWorkbook.Application.Quit();
objPres.Application.Quit();

public static void EnsurePowerPointIsRunning(bool blnAddPresentation)
{
    EnsurePowerPointIsRunning(blnAddPresentation, false);
}

public static void EnsurePowerPointIsRunning()
{
    EnsurePowerPointIsRunning(false, false);
}

public static void EnsurePowerPointIsRunning(bool blnAddPresentation, bool blnAddSlide)
{
    string strName = null;

    // Versuchen Sie, die Name-Eigenschaft zuzugreifen. Wenn dabei eine Ausnahme geworfen wird, starten Sie eine neue Instanz von PowerPoint.
    try
    {
        strName = objPPT.Name;
    }
    catch (Exception ex)
    {
        StartPowerPoint();
    }

    // blnAddPresentation wird verwendet, um sicherzustellen, dass eine Präsentation geladen ist.
    if (blnAddPresentation == true)
    {
        try
        {
            strName = objPres.Name;
        }
        catch (Exception ex)
        {
            objPres = objPPT.Presentations.Add(MsoTriState.msoTrue);
        }
    }

    // blnAddSlide wird verwendet, um sicherzustellen, dass in der Präsentation mindestens eine Folie vorhanden ist.
    if (blnAddSlide)
    {
        try
        {
            strName = objPres.Slides[1].Name;
        }
        catch (Exception ex)
        {
            Microsoft.Office.Interop.PowerPoint.Slide objSlide = null;
            Microsoft.Office.Interop.PowerPoint.CustomLayout objCustomLayout = null;
            objCustomLayout = objPres.SlideMaster.CustomLayouts[1];
            objSlide = objPres.Slides.AddSlide(1, objCustomLayout);
            objSlide.Layout = Microsoft.Office.Interop.PowerPoint.PpSlideLayout.ppLayoutText;
            objCustomLayout = null;
            objSlide = null;
        }
    }
}

Das Ergebnis:

Das mit VSTO erstellte Diagramm

Aspose.Slides für .NET‑Beispiel

Das folgende Beispiel zeigt, wie man ein einfaches Diagramm in einer PowerPoint‑Präsentation mit Aspose.Slides für .NET erstellt. Der Code demonstriert das Hinzufügen eines 3D‑Clustered‑Column‑Diagramms, das Befüllen mit Beispieldaten und die Anpassung des Erscheinungsbilds. Mit nur wenigen Codezeilen können Sie Diagramme dynamisch erzeugen und in Ihre Präsentationen integrieren, ohne Microsoft Office zu verwenden.

  1. Erstellen Sie eine Instanz der Presentation‑Klasse.
  2. Holen Sie sich eine Referenz auf die erste Folie.
  3. Fügen Sie ein 3D‑Clustered‑Column‑Diagramm hinzu und greifen Sie darauf zu.
  4. Greifen Sie auf die Diagrammdaten zu.
  5. Entfernen Sie die nicht verwendeten Series 2 und 3.
  6. Ändern Sie die Diagrammkategorien, indem Sie die Beschriftungen aktualisieren.
  7. Aktualisieren Sie die Werte von Series 1.
  8. Greifen Sie auf den Diagrammtitel zu und setzen Sie dessen Schrift‑Eigenschaften.
  9. Konfigurieren Sie die Wertachse des Diagramms, einschließlich Haupteinheit, Nebeneinheit, Maximal‑ und Minimalwert.
  10. Setzen Sie die Rotationswinkel des Diagramms auf den X‑ und Y‑Achsen.
  11. Speichern Sie die Präsentation im PPTX‑Format.
// Erstelle eine leere Präsentation.
using (Presentation presentation = new Presentation())
{
    // Greife auf die erste Folie zu.
    ISlide slide = presentation.Slides[0];

    // Füge ein Standarddiagramm hinzu.
    IChart chart = slide.Shapes.AddChart(ChartType.ClusteredColumn3D, 20, 30, 400, 300);

    // Hole die Diagrammdaten.
    IChartData chartData = chart.ChartData;

    // Entferne die zusätzlichen Standardserien.
    chartData.Series.RemoveAt(1);
    chartData.Series.RemoveAt(1);

    // Ändere die Diagrammkategorienamen.
    chartData.Categories[0].AsCell.Value = "Bikes";
    chartData.Categories[1].AsCell.Value = "Accessories";
    chartData.Categories[2].AsCell.Value = "Repairs";
    chartData.Categories[3].AsCell.Value = "Clothing";

    // Setze den Index des Diagrammdaten-Arbeitsblatts.
    int worksheetIndex = 0;

    // Hole die Diagrammdaten-Arbeitsmappe.
    IChartDataWorkbook workbook = chart.ChartData.ChartDataWorkbook;

    // Ändere die Diagramm-Serienwerte.
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 1, 1, 1000));
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 2, 1, 2500));
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 3, 1, 4000));
    chartData.Series[0].DataPoints.AddDataPointForBarSeries(workbook.GetCell(worksheetIndex, 4, 1, 3000));

    // Setze den Diagrammtitel.
    chart.HasTitle = true;
    chart.ChartTitle.AddTextFrameForOverriding("2007 Sales");
    IPortionFormat format = chart.ChartTitle.TextFrameForOverriding.Paragraphs[0].Portions[0].PortionFormat;
    format.FontItalic = NullableBool.True;
    format.FontHeight = 18;
    format.FillFormat.FillType = FillType.Solid;
    format.FillFormat.SolidFillColor.Color = Color.Black;

    // Setze die Achsenoptionen.
    chart.Axes.VerticalAxis.IsAutomaticMaxValue = false;
    chart.Axes.VerticalAxis.IsAutomaticMinValue = false;
    chart.Axes.VerticalAxis.IsAutomaticMajorUnit = false;
    chart.Axes.VerticalAxis.IsAutomaticMinorUnit = false;

    chart.Axes.VerticalAxis.MaxValue = 4000.0F;
    chart.Axes.VerticalAxis.MinValue = 0.0F;
    chart.Axes.VerticalAxis.MajorUnit = 2000.0F;
    chart.Axes.VerticalAxis.MinorUnit = 1000.0F;
    chart.Axes.VerticalAxis.TickLabelPosition = TickLabelPositionType.NextTo;

    // Setze die Diagrammrotation.
    chart.Rotation3D.RotationX = 15;
    chart.Rotation3D.RotationY = 20;

    // Speichere die Präsentation als PPTX-Datei.
    presentation.Save("Aspose_Sample_Chart.pptx", SaveFormat.Pptx);
}

Das Ergebnis:

Das mit Aspose.Slides für .NET erstellte Diagramm

FAQs

Kann ich mit Aspose.Slides auch andere Diagrammtypen wie Kreis-, Linien‑ oder Balkendiagramme erstellen?

Ja. Aspose.Slides für .NET unterstützt eine breite Palette von Diagrammtypen, darunter Kreisdiagramme, Liniendiagramme, Balkendiagramme, Punkt‑ und Blasendiagramme und mehr. Sie können den gewünschten Diagrammtyp über die Aufzählung ChartType beim Hinzufügen eines Diagramms angeben.

Kann ich benutzerdefinierte Stile oder Designs auf das Diagramm anwenden?

Ja. Sie können das Aussehen des Diagramms vollständig anpassen, einschließlich Farben, Schriftarten, Füllungen, Konturen, Gitternetzlinien und Layout. Das exakte Anwenden von Office‑Designs, wie sie in PowerPoint zu sehen sind, erfordert jedoch das manuelle Setzen einzelner Stil‑Eigenschaften.

Kann ich das Diagramm als eigenständiges Bild aus der Folie exportieren?

Ja, Aspose.Slides ermöglicht den Export jeder Form – einschließlich Diagrammen – als separates Bild (z. B. PNG, JPEG) über die GetImage‑Methode der Diagramm‑shape.

Excel-Diagramme als OLE-Objekte mit VSTO und Aspose.Slides für .NET erstellen und einbetten