Anpassen von Diagrammen

Erstellen von Diagrammen

Mit Aspose.Cells können Tabellenkalkulationen eine Vielzahl von Diagrammen hinzugefügt werden. Aspose.Cells bietet viele flexible Diagrammobjekte. In diesem Thema werden Aspose.Cells-Diagrammobjekte behandelt.

Einfach ein Diagramm erstellen

Es ist einfach, ein Diagramm mit Aspose.Cells mit den folgenden Beispielcodes zu erstellen:

Wissenswertes zum Erstellen eines Diagramms

Vor dem Erstellen von Diagrammen ist es wichtig, einige grundlegende Konzepte zu verstehen, die beim Erstellen von Diagrammen mit Aspose.Cells hilfreich sind.

Diagrammobjekte

Aspose.Cells bietet einen speziellen Satz von Klassen, die zum Erstellen aller Arten von Diagrammen verwendet werden. Diese Klassen werden zum Erstellen verwendetDiagrammobjekte, 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 in einer Reihe enthält.
• ChartCollection , eine Sammlung vonDiagrammObjekte.
• DataLabels, DataLabels für die angegebenenSerie, ChartPoint, Trendlinie, etc.
• Füllformat, Füllformat für eine Form.
• Umhauen, der Boden eines 3D-Diagramms.
• Legende, die Diagrammlegende.
• Linie, die Diagrammlinie.
• SerieSammlung , eine Sammlung vonSerieObjekte.
• Serie, stellt eine einzelne Datenreihe in einem Diagramm dar.
• TickLabels, die 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 Trendline-Objekte 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 bereit, um spezifische Aufgaben auszuführen. Verwenden Sie Diagrammobjekte, um Diagramme zu erstellen.

Fügen Sie einem Arbeitsblatt mithilfe von beliebige Diagrammtypen hinzuChartCollection Sammlung. Jeder Artikel in derChartCollection Sammlung repräsentiert aDiagramm Objekt. EINDiagramm-Objekt kapselt alle Diagrammobjekte, die zum Anpassen des Aussehens des Diagramms erforderlich sind. Der nächste Abschnitt zeigt, wie Sie mit einigen grundlegenden Diagrammobjekten ein einfaches Diagramm erstellen.

Erstellen eines einfachen Diagramms

Mit Aspose.Cells können viele verschiedene Arten von Diagrammen erstellt werden. Alle von Aspose.Cells unterstützten Standarddiagramme sind in einer Enumeration mit dem Namen vordefiniertDiagramm Typ. Die vordefinierten Diagrammtypen sind:

Diagrammtypen	Beschreibung
Spalte	Stellt das gruppierte Säulendiagramm dar
Spalte gestapelt	Stellt ein gestapeltes Säulendiagramm dar
Spalte 100 Prozent gestapelt	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 gestapeltes 3D-Säulendiagramm mit 100 % dar
Spalte3D	Stellt ein 3D-Säulendiagramm dar
Bar	Stellt gruppiertes Balkendiagramm dar
BarStacked	Stellt ein gestapeltes Balkendiagramm dar
Balken 100 Prozent gestapelt	Stellt ein 100 % gestapeltes Balkendiagramm dar
Bar3DClustered	Stellt ein gruppiertes 3D-Balkendiagramm dar
Bar3DStacked	Stellt ein gestapeltes 3D-Balkendiagramm dar
Bar3D100PercentStacked	Stellt ein 100 % gestapeltes 3D-Balkendiagramm dar
Linie	Stellt Liniendiagramm dar
LineStacked	Stellt ein gestapeltes Liniendiagramm dar
Zeile 100 Prozent gestapelt	Stellt ein 100 % gestapeltes Liniendiagramm dar
LineWithDataMarkers	Stellt 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 Kreisdiagramm dar
Pie3D	Stellt ein 3D-Kreisdiagramm dar
PiePie	Stellt ein Kreisdiagramm dar
Kuchenexplodiert	Stellt ein explodiertes Kreisdiagramm dar
Pie3D Explodiert	Stellt ein explodiertes 3D-Kreisdiagramm dar
PieBar	Stellt den Balken des 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 dar, ohne Datenmarkierungen
Bereich	Stellt das Flächendiagramm dar
BereichStacked	Stellt ein gestapeltes Flächendiagramm dar
Area100ProcentStacked	Stellt ein 100 % gestapeltes Flächendiagramm dar
Bereich3D	Stellt ein 3D-Flächendiagramm dar
Area3DStacked	Stellt ein gestapeltes 3D-Flächendiagramm dar
Area3D100ProzentStacked	Stellt ein 100 % gestapeltes 3D-Flächendiagramm dar
Krapfen	Stellt das Donut-Diagramm dar
Donut Explodiert	Stellt das explodierte Donut-Diagramm dar
Radar	Stellt das Netzdiagramm dar
RadarWithDataMarkers	Stellt das Netzdiagramm mit Datenmarkierungen dar
Radargefüllt	Stellt ein gefülltes Netzdiagramm dar
Surface3D	Stellt ein 3D-Oberflächendiagramm dar
SurfaceWireframe3D	Stellt das Drahtgitter-3D-Oberflächendiagramm dar
Oberflächenkontur	Stellt das Konturdiagramm dar
SurfaceContourWireframe	Stellt das Drahtmodell-Konturdiagramm dar
Blase	Stellt das Blasendiagramm dar
Bubble3D	Stellt ein 3D-Blasendiagramm dar
Zylinder	Stellt das Zylinderdiagramm dar
Zylinder gestapelt	Stellt das gestapelte Zylinderdiagramm dar
Zylinder 100 Prozent gestapelt	Repräsentiert ein 100 % gestapeltes Zylinderdiagramm
Zylindrischer Stab	Stellt ein zylindrisches Balkendiagramm dar.
ZylindrischBarStacked	Stellt ein gestapeltes zylindrisches Balkendiagramm dar
ZylindrischBar100ProzentGestapelt	Stellt ein 100 % gestapeltes zylindrisches Balkendiagramm dar
ZylindrischeSäule3D	Stellt ein zylindrisches 3D-Säulendiagramm dar
Kegel	Stellt das Kegeldiagramm dar
Kegelgestapelt	Stellt das gestapelte Kegeldiagramm dar
Kegel 100 Prozent gestapelt	Stellt ein 100 % gestapeltes Kegeldiagramm dar
Konische Stange	Stellt ein konisches Balkendiagramm dar
ConicalBarStacked	Stellt ein gestapeltes konisches Balkendiagramm dar
ConicalBar100ProcentStacked	Stellt ein 100 % gestapeltes konisches Balkendiagramm dar
KonischeSäule3D	Stellt ein konisches 3D-Säulendiagramm dar
Pyramide	Stellt Pyramidendiagramm dar
PyramidStacked	Stellt ein gestapeltes Pyramidendiagramm dar
Pyramid100Prozent gestapelt	Stellt ein 100 % gestapeltes Pyramidendiagramm dar
PyramidBar	Stellt das Pyramiden-Balkendiagramm dar
PyramidBarStacked	Stellt ein gestapeltes Pyramiden-Balkendiagramm dar
PyramidBar100PercentStacked	Stellt ein 100 % gestapeltes Pyramiden-Balkendiagramm dar
PyramidColumn3D	Stellt ein 3D-Pyramiden-Säulendiagramm dar
So erstellen Sie ein Diagramm mit Aspose.Cells:

1. Fügen Sie einige Daten zu Arbeitsblattzellen mit hinzuCell ObjektsetValueMethode. Dies wird als Datenquelle für das Diagramm verwendet.
2. Fügen Sie dem Arbeitsblatt ein Diagramm hinzu, indem Sie die aufrufenChartCollection Sammlungaddieren-Methode, gekapselt in derArbeitsblattObjekt.
3. Geben Sie den Diagrammtyp mit anDiagramm TypAufzählung. Beispielsweise verwendet das Beispiel dieChartType.PYRAMIDvalue als Diagrammtyp.
4. Greifen Sie auf das Neue zuDiagramm Objekt aus derChartCollection-Sammlung, indem ihr Index übergeben wird.
5. Verwenden Sie eines der Diagrammobjekte, die in gekapselt sindDiagrammObjekt, um das Diagramm zu verwalten. Das folgende Beispiel verwendet dieSerieSammlungcharting-Objekt, um die Datenquelle des Diagramms anzugeben.

Beim Hinzufügen von Quelldaten zum 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 sein Werte (z. B. “1,2,3”).

Wenn Sie einen Zellbereich als Datenquelle zuweisen, können Sie den Bereich nur von links oben nach rechts unten festlegen. Beispielsweise ist „A1:C3“ gültig, während „C3:A1“ ungültig ist.

Mit diesen allgemeinen Schritten können Sie jede Art von Diagramm erstellen. Verwenden Sie verschiedene Diagrammobjekte, um verschiedene Diagramme zu erstellen.

Wenn der Beispielcode ausgeführt wird, wird dem Arbeitsblatt wie unten gezeigt ein Pyramidendiagramm hinzugefügt.

Pyramidendiagramm mit seiner Datenquelle

Um ein Blasendiagramm zu erstellen, dieDiagramm Typmuss eingestellt werdenChartType.BUBBLEund einige zusätzliche Eigenschaften wie BubbleSizes, Values & XValues müssen entsprechend eingestellt 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 dieDiagramm Typmuss eingestellt werdenDiagrammtyp.LINE_WITH_DATA_MARKERS und einige zusätzliche Eigenschaften wie Hintergrundbereich, Serienmarkierungen, Werte und XWerte müssen entsprechend festgelegt werden. Beim Ausführen des folgenden Codes wird dem Arbeitsblatt eine Zeile mit einem Datenmarkierungsdiagramm hinzugefügt.

Erstellen von benutzerdefinierten Diagrammen

Bisher haben wir uns bei der Erörterung von Diagrammen mit Standarddiagrammen befasst, die über ihre Standardformatierungseinstellungen verfügen. Wir definieren nur die Datenquelle, legen ein paar Eigenschaften fest und das Diagramm wird mit seinen Standardformateinstellungen erstellt. Aber Aspose.Cells unterstützt auch das Erstellen benutzerdefinierter Diagramme, mit denen Entwickler Diagramme mit ihren eigenen Formateinstellungen erstellen können.

Erstellen von benutzerdefinierten Diagrammen

Entwickler können benutzerdefinierte Diagramme zur Laufzeit mit Aspose.Cells einfach API erstellen.

Ein Diagramm besteht aus einer Datenreihe. Jede Datenreihe in Aspose.Cells wird durch a dargestelltSerie Objekt, während dieSerieSammlung Objekt dient als Sammlung vonSerieObjekte. Beim Erstellen eines benutzerdefinierten Diagramms haben Entwickler die Freiheit, verschiedene Arten von Diagrammen für verschiedene Datenreihen (gesammelt in einerSerieSammlungObjekt).

Derzeit unterstützt Aspose.Cells nur benutzerdefinierte Diagramme, die Torten-, Linien-, Säulen- und Säulenstapeldiagramme kombinieren, aber in zukünftigen Versionen werden weitere Diagramme unterstützt. Eine vollständige Liste der von Aspose.Cells unterstützten Standarddiagramme finden Sie unterDiagrammtypen Artikel.

Der folgende Beispielcode zeigt, wie benutzerdefinierte Diagramme erstellt werden. 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

Um eine Liste der unterstützten Diagrammtypen anzuzeigen, lesen Sie dieDiagrammtypen Artikel.