Anpassen von Diagrammen
Diagramme erstellen
Mit Aspose.Cells ist es möglich, eine Vielzahl von Diagrammen zu Tabellenkalkulationen hinzuzufügen. Aspose.Cells bietet viele flexible Diagrammobjekte. In diesem Thema werden Diagrammobjekte vom Typ Aspose.Cells erläutert.
Einfach ein Diagramm erstellen
Mit den folgenden Beispielcodes können Sie ganz einfach ein Diagramm mit Aspose.Cells erstellen:
Wissenswertes zum Erstellen eines Diagramms
Bevor Sie Diagramme erstellen, ist es wichtig, einige grundlegende Konzepte zu verstehen, die beim Erstellen von Diagrammen mit Aspose.Cells hilfreich sind.
Diagrammobjekte
Aspose.Cells stellt einen speziellen Satz von Klassen bereit, mit denen alle Arten von Diagrammen erstellt werden können. Mit diesen Klassen werden Diagrammobjekte* erstellt, die als Diagrammbausteine fungieren. Die Diagrammobjekte sind unten aufgeführt:
- Achse, die Achse eines Diagramms.
- Diagramm, ein einzelnes Excel-Diagramm.
- ChartArea, der Diagrammbereich im Arbeitsblatt.
- ChartDataTable, eine Diagrammdatentabelle.
- ChartFrame, das Rahmenobjekt in einem Diagramm.
- ChartPoint, ein einzelner Punkt in einer Reihe in einem Diagramm.
- ChartPointCollection, eine Sammlung, die alle Punkte einer Reihe enthält.
- ChartCollection , eine Sammlung vonDiagrammObjekte.
- DataLabels, DataLabels für die angegebenenSerie, ChartPoint, Trendlinie, usw.
- FillFormat, Füllformat für eine Form.
- Boden, der Boden eines 3D-Diagramms.
- Legende, die Diagrammlegende.
- Linie, die Diagrammlinie.
- SeriesCollection , eine Sammlung vonSerieObjekte.
- Serie, stellt eine einzelne Datenreihe in einem Diagramm dar.
- TickLabelsdie Teilstrichbeschriftungen, die Teilstrichen auf einer Diagrammachse zugeordnet sind.
- Titel, der Titel eines Diagramms oder einer Achse.
- Trendlinie, eine Trendlinie in einem Diagramm.
- TrendlineCollection, eine Sammlung aller Trendlinienobjekte für die angegebene Datenreihe.
- Wände, die Wände eines 3D-Diagramms.
Verwenden von Diagrammobjekten
Wie oben erwähnt, sind alle Diagrammobjekte Instanzen ihrer jeweiligen Klassen und stellen spezifische Eigenschaften und Methoden zur Ausführung bestimmter Aufgaben bereit. Verwenden Sie Diagrammobjekte, um Diagramme zu erstellen.
Fügen Sie einem Arbeitsblatt eine beliebige Art von Diagramm hinzu, indem Sie die verwendenChartCollection Sammlung. Jedes Element in derChartCollection Sammlung repräsentiert aDiagramm Objekt. ADiagrammDas Objekt kapselt alle Diagrammobjekte, die zum Anpassen des Erscheinungsbilds des Diagramms erforderlich sind. Im nächsten Abschnitt wird gezeigt, wie Sie mit einigen grundlegenden Diagrammobjekten ein einfaches Diagramm erstellen.
Erstellen eines einfachen Diagramms
Mit Aspose.Cells ist es möglich, viele verschiedene Arten von Diagrammen zu erstellen. Alle von Aspose.Cells unterstützten Standarddiagramme sind in einer Aufzählung mit dem Namen vordefiniertDiagramm Typ. Die vordefinierten Diagrammtypen sind:
Diagrammtypen | Beschreibung |
---|---|
Spalte | Stellt das gruppierte Säulendiagramm dar |
ColumnStacked | Stellt ein gestapeltes Säulendiagramm dar |
Column100PercentStacked | Stellt ein 100 % gestapeltes Säulendiagramm dar |
Column3DClustered | Stellt ein gruppiertes 3D-Säulendiagramm dar |
Column3DStacked | Stellt ein gestapeltes 3D-Säulendiagramm dar |
Column3D100PercentStacked | Stellt ein zu 100 % gestapeltes 3D-Säulendiagramm dar |
Column3D | Stellt ein 3D-Säulendiagramm dar |
Bar | Stellt ein gruppiertes Balkendiagramm dar |
BarStacked | Stellt ein gestapeltes Balkendiagramm dar |
Bar100PercentStacked | Stellt ein 100 % gestapeltes Balkendiagramm dar |
Bar3DClustered | Stellt ein gruppiertes 3D-Balkendiagramm dar |
Bar3DStacked | Stellt ein gestapeltes 3D-Balkendiagramm dar |
Bar3D100PercentStacked | Stellt ein zu 100 % gestapeltes 3D-Balkendiagramm dar |
Linie | Stellt ein Liniendiagramm dar |
LineStacked | Stellt ein gestapeltes Liniendiagramm dar |
Line100PercentStacked | Stellt ein 100 % gestapeltes Liniendiagramm dar |
LineWithDataMarkers | Stellt ein Liniendiagramm mit Datenmarkierungen dar |
LineStackedWithDataMarkers | Stellt ein gestapeltes Liniendiagramm mit Datenmarkierungen dar |
Line100PercentStackedWithDataMarkers | Stellt ein 100 % gestapeltes Liniendiagramm mit Datenmarkierungen dar |
Line3D | Stellt ein 3D-Liniendiagramm dar |
Kuchen | Stellt ein Kreisdiagramm dar |
Pie3D | Stellt ein 3D-Kreisdiagramm dar |
PiePie | Stellt einen Kreis des Kreisdiagramms dar |
PieExploded | Stellt ein explodiertes Kreisdiagramm dar |
Pie3DEExploded | Stellt ein 3D-Explosions-Kreisdiagramm dar |
PieBar | Stellt einen Balken eines Kreisdiagramms dar |
Streuen | Stellt das Streudiagramm dar |
ScatterConnectedByCurvesWithDataMarker | Stellt das durch Kurven verbundene Streudiagramm mit Datenmarkierungen dar |
ScatterConnectedByCurvesWithoutDataMarker | Stellt das durch Kurven verbundene Streudiagramm ohne Datenmarkierungen dar |
ScatterConnectedByLinesWithDataMarker | Stellt das durch Linien verbundene Streudiagramm mit Datenmarkierungen dar |
ScatterConnectedByLinesWithoutDataMarker | Stellt das durch Linien verbundene Streudiagramm ohne Datenmarkierungen dar |
Bereich | Stellt ein Flächendiagramm dar |
BereichGestapelt | Stellt ein gestapeltes Flächendiagramm dar |
Fläche100PercentStacked | Stellt ein 100 % gestapeltes Flächendiagramm dar |
Area3D | Stellt ein 3D-Flächendiagramm dar |
Area3DStacked | Stellt ein gestapeltes 3D-Flächendiagramm dar |
Area3D100PercentStacked | Stellt ein 3D-100 %-Stapelflächendiagramm dar |
Krapfen | Stellt ein Donut-Diagramm dar |
DonutExplodiert | Stellt ein explodiertes Donut-Diagramm dar |
Radar | Stellt das Radardiagramm dar |
RadarWithDataMarkers | Stellt das Radardiagramm mit Datenmarkierungen dar |
Radargefüllt | Stellt ein gefülltes Radardiagramm dar |
Surface3D | Stellt ein 3D-Oberflächendiagramm dar |
OberflächeWireframe3D | Stellt das Wireframe-3D-Oberflächendiagramm dar |
Oberflächenkontur | Stellt ein Konturdiagramm dar |
SurfaceContourWireframe | Stellt ein Drahtmodell-Konturdiagramm dar |
Blase | Stellt ein Blasendiagramm dar |
Bubble3D | Stellt ein 3D-Blasendiagramm dar |
Zylinder | Stellt ein Zylinderdiagramm dar |
Zylindergestapelt | Stellt ein gestapeltes Zylinderdiagramm dar |
Zylinder100PercentStacked | Stellt ein 100 % gestapeltes Zylinderdiagramm dar |
Zylindrischer Balken | Stellt ein zylindrisches Balkendiagramm dar. |
CylindricalBarStacked | Stellt ein gestapeltes zylindrisches Balkendiagramm dar |
CylindricalBar100PercentStacked | Stellt ein zu 100 % gestapeltes zylindrisches Balkendiagramm dar |
Zylindrische Spalte3D | Stellt ein zylindrisches 3D-Säulendiagramm dar |
Kegel | Stellt ein Kegeldiagramm dar |
Kegelgestapelt | Stellt ein gestapeltes Kegeldiagramm dar |
Cone100PercentStacked | Stellt ein 100 % gestapeltes Kegeldiagramm dar |
ConicalBar | Stellt ein konisches Balkendiagramm dar |
ConicalBarStacked | Stellt ein gestapeltes konisches Balkendiagramm dar |
ConicalBar100PercentStacked | Stellt ein zu 100 % gestapeltes konisches Balkendiagramm dar |
ConicalColumn3D | Stellt ein konisches 3D-Säulendiagramm dar |
Pyramide | Stellt ein Pyramidendiagramm dar |
PyramidStacked | Stellt ein gestapeltes Pyramidendiagramm dar |
Pyramid100PercentStacked | Stellt ein 100 % gestapeltes Pyramidendiagramm dar |
PyramidBar | Stellt das Pyramiden-Balkendiagramm dar |
PyramidBarStacked | Stellt ein gestapeltes Pyramidenbalkendiagramm dar |
PyramidBar100PercentStacked | Stellt ein 100 % gestapeltes Pyramidenbalkendiagramm dar |
PyramidColumn3D | Stellt ein 3D-Pyramiden-Säulendiagramm dar |
So erstellen Sie ein Diagramm mit Aspose.Cells: |
- Fügen Sie mit dem einige Daten zu Arbeitsblattzellen hinzuCell ObjektsetValueMethode. Dies wird als Datenquelle für das Diagramm verwendet.
- Fügen Sie dem Arbeitsblatt ein Diagramm hinzu, indem Sie das aufrufenChartCollection Sammlunghinzufügen-Methode, gekapselt in derArbeitsblattObjekt.
- Geben Sie den Diagrammtyp mit anDiagramm TypAufzählung. Das Beispiel verwendet beispielsweise dieChartType.PYRAMIDWert als Diagrammtyp.
- Greifen Sie auf das Neue zuDiagramm Objekt aus demChartCollectionSammlung durch Übergabe ihres Index.
- Verwenden Sie eines der im gekapselten DiagrammobjekteDiagrammObjekt zum Verwalten des Diagramms. Das folgende Beispiel verwendet dieSeriesCollectionDiagrammobjekt, um die Datenquelle des Diagramms anzugeben.
Beim Hinzufügen von Quelldaten zu einem Diagramm kann die Datenquelle ein Zellbereich (z. B. „A1:C3“) oder eine Folge nicht zusammenhängender Zellen (z. B. „A1, A3, A5“) oder eine Folge von Zellen sein Werte (z. B. „1,2,3“).
Mit diesen allgemeinen Schritten können Sie jede Art von Diagramm erstellen. Verwenden Sie unterschiedliche Diagrammobjekte, um unterschiedliche Diagramme zu erstellen.
Wenn der Beispielcode ausgeführt wird, wird dem Arbeitsblatt ein Pyramidendiagramm hinzugefügt, wie unten gezeigt.
Pyramidendiagramm mit seiner Datenquelle
Um ein Blasendiagramm zu erstellen, müssen Sie Folgendes tun:Diagramm Typmuss eingestellt werdenChartType.BUBBLEund einige zusätzliche Eigenschaften wie BubbleSizes, Values und XValues müssen entsprechend festgelegt werden. Beim Ausführen des folgenden Codes wird dem Arbeitsblatt ein Blasendiagramm hinzugefügt, wie unten gezeigt.
Blasendiagramm mit seiner Datenquelle
Linie mit Datenmarkierungsdiagramm
Um eine Linie mit einem Datenmarkierungsdiagramm zu erstellen, müssen Sie Folgendes tun:Diagramm Typmuss eingestellt werdenChartType.LINE_WITH_DATA_MARKERS und einige zusätzliche Eigenschaften wie Hintergrundbereich, Serienmarkierungen, Werte und X-Werte müssen entsprechend festgelegt werden. Beim Ausführen des folgenden Codes wird dem Arbeitsblatt eine Zeile mit einem Datenmarkierungsdiagramm hinzugefügt.
Erstellen benutzerdefinierter Diagramme
Bisher haben wir uns bei der Besprechung von Diagrammen mit Standarddiagrammen befasst, die über ihre Standardformatierungseinstellungen verfügen. Wir definieren nur die Datenquelle, legen einige Eigenschaften fest und das Diagramm wird mit seinen Standardformateinstellungen erstellt. Aber Aspose.Cells unterstützt auch die Erstellung benutzerdefinierter Diagramme, die es Entwicklern ermöglichen, Diagramme mit ihren eigenen Formateinstellungen zu erstellen.
Erstellen benutzerdefinierter Diagramme
Entwickler können zur Laufzeit benutzerdefinierte Diagramme erstellen, indem sie Aspose.Cells einfach API verwenden.
Ein Diagramm besteht aus einer Datenreihe. Jede Datenreihe in Aspose.Cells wird durch a dargestelltSerie Objekt, während dieSeriesCollection Das Objekt dient als Sammlung vonSerieObjekte. Beim Erstellen eines benutzerdefinierten Diagramms haben Entwickler die Freiheit, verschiedene Diagrammtypen für unterschiedliche Datenreihen (gesammelt in einem) zu verwendenSeriesCollectionObjekt).
Der folgende Beispielcode zeigt, wie Sie benutzerdefinierte Diagramme erstellen. In diesem Beispiel verwenden wir ein Säulendiagramm für die erste Datenreihe und ein Liniendiagramm für die zweite Reihe. Das Ergebnis ist, dass wir dem Arbeitsblatt ein Säulendiagramm in Kombination mit einem Liniendiagramm hinzufügen.
Benutzerdefiniertes Diagramm, das Säulen- und Liniendiagramme kombiniert
Programmierbeispiel