Diagramme anpassen
Erstellen von Diagrammen
Es ist möglich, verschiedene Diagramme zu Tabellenkalkulationen mit Aspose.Cells hinzuzufügen. Aspose.Cells bietet viele flexible Diagrammobjekte. In diesem Themenbereich werden die Diagrammobjekte von Aspose.Cells diskutiert.
Einfaches Erstellen eines Diagramms
Es ist einfach, mit Aspose.Cells ein Diagramm zu erstellen, mit den folgenden Beispielcodes:
Dinge, die Sie für die Erstellung eines Diagramms wissen sollten
Bevor Sie Diagramme erstellen, ist es wichtig, einige grundlegende Konzepte zu verstehen, die hilfreich sind, wenn Sie Diagramme mit Aspose.Cells erstellen.
Diagrammobjekte
Aspose.Cells bietet eine spezielle Reihe von Klassen zum Erstellen aller Arten von Diagrammen. Diese Klassen werden verwendet, um Diagrammobjekte zu erstellen, die als Bausteine für den Diagrammaufbau dienen. Die Diagrammobjekte sind unten aufgeführt:
- Axis, eine Achse des Diagramms.
- Chart, ein einzelnes Excel-Diagramm.
- ChartArea, der Diagrammbereich im Arbeitsblatt.
- ChartDataTable, eine Diagrammdatentabelle.
- ChartFrame, das Rahmenelement in einem Diagramm.
- ChartPoint, ein einzelner Punkt in einer Serie in einem Diagramm.
- ChartPointCollection, eine Sammlung, die alle Punkte in einer Serie enthält.
- ChartCollection, eine Sammlung von Chart Objekten.
- Datenbeschriftungen, Datenbeschriftungen für das angegebene Series, ChartPoint, Trendline, usw.
- FillFormat, Füllformat für eine Form.
- Floor, die Basis eines 3D-Diagramms.
- Legend, die Diagrammlegende.
- Line, die Diagrammlinie.
- SeriesCollection, eine Sammlung von Series Objekten.
- Series, stellt eine einzelne Datenreihe in einem Diagramm dar.
- TickLabels, die Zeichenbeschriftungen, die mit den Zeichen an einer Diagrammachse verbunden sind.
- Title, der Titel eines Diagramms oder einer Achse.
- Trendline, eine Trendlinie in einem Diagramm.
- TrendlineCollection, eine Sammlung aller Trendline-Objekte für die angegebene Datenreihe.
- Walls, die Wände eines 3D-Diagramms.
Verwendung von Diagrammobjekten
Wie oben erwähnt, sind alle Diagrammobjekte Instanzen ihrer jeweiligen Klassen und bieten spezifische Eigenschaften und Methoden zur Ausführung bestimmter Aufgaben. Verwenden Sie Diagrammobjekte, um Diagramme zu erstellen.
Fügen Sie mithilfe der ChartCollection Sammlung jeden beliebigen Diagrammtyp zu einem Arbeitsblatt hinzu. Jedes Element in der ChartCollection Sammlung stellt ein Chart Objekt dar. Ein Chart Objekt umfasst alle Diagrammobjekte, die erforderlich sind, um das Erscheinungsbild des Diagramms anzupassen. Der nächste Abschnitt zeigt, wie einige grundlegende Diagrammobjekte verwendet werden, um ein einfaches Diagramm zu erstellen.
Erstellen eines einfachen Diagramms
Es ist möglich, mit Aspose.Cells viele verschiedene Arten von Diagrammen zu erstellen. Alle von Aspose.Cells unterstützten Standarddiagramme sind in einer Aufzählung namens ChartType vordefiniert. Die vordefinierten Diagrammtypen sind:
| Diagrammtypen | Beschreibung |
|---|---|
| Column | Stellt das gruppierte Balkendiagramm dar |
| ColumnStacked | Stellt gestapeltes Säulendiagramm dar |
| Column100PercentStacked | Stellt zu 100 % gestapeltes Säulendiagramm dar |
| Column3DClustered | Stellt 3D-gruppiertes Säulendiagramm dar |
| Column3DStacked | Stellt 3D-gestapeltes Säulendiagramm dar |
| Column3D100PercentStacked | Stellt 3D-100%-gestapeltes Säulendiagramm dar |
| Column3D | Stellt 3D-Säulendiagramm dar |
| Bar | Stellt gestapeltes Balkendiagramm dar |
| BarStacked | Stellt gestapeltes Balkendiagramm dar |
| Bar100PercentStacked | Stellt 100%-gestapeltes Balkendiagramm dar |
| Bar3DClustered | Stellt 3D-gruppiertes Balkendiagramm dar |
| Bar3DStacked | Stellt 3D-gestapeltes Balkendiagramm dar |
| Bar3D100PercentStacked | Stellt 3D-100%-gestapeltes Balkendiagramm dar |
| Line | Stellt Liniendiagramm dar |
| LineStacked | Stellt gestapeltes Liniendiagramm dar |
| Line100PercentStacked | Stellt 100%-gestapeltes Liniendiagramm dar |
| LineWithDataMarkers | Stellt Liniendiagramm mit Datenmarkierungen dar |
| LineStackedWithDataMarkers | Stellt gestapeltes Liniendiagramm mit Datenmarkierungen dar |
| Line100PercentStackedWithDataMarkers | Stellt 100%-gestapeltes Liniendiagramm mit Datenmarkierungen dar |
| Line3D | Stellt 3D-Liniendiagramm dar |
| Pie | Stellt Tortendiagramm dar |
| Pie3D | Stellt 3D-Tortendiagramm dar |
| PiePie | Stellt Tortendiagramm von Tortendiagramm dar |
| PieExploded | Stellt explodiertes Tortendiagramm dar |
| Pie3DExploded | Stellt ein 3D-Sprengkuchendiagramm dar |
| PieBar | Stellt Balken eines Kuchendiagramms dar |
| Scatter | Stellt das Punktdiagramm dar |
| ScatterConnectedByCurvesWithDataMarker | Stellt das über Kurven verbundene Punktdiagramm mit Datenmarkierungen dar |
| ScatterConnectedByCurvesWithoutDataMarker | Stellt das über Kurven verbundene Punktdiagramm ohne Datenmarkierungen dar |
| ScatterConnectedByLinesWithDataMarker | Stellt das über Linien verbundene Punktdiagramm mit Datenmarkierungen dar |
| ScatterConnectedByLinesWithoutDataMarker | Stellt das über Linien verbundene Punktdiagramm ohne Datenmarkierungen dar |
| Area | Stellt ein Flächendiagramm dar |
| AreaStacked | Stellt ein gestapeltes Flächendiagramm dar |
| Area100PercentStacked | Stellt ein 100 % gestapeltes Flächendiagramm dar |
| Area3D | Stellt ein 3D-Flächendiagramm dar |
| Area3DStacked | Stellt ein 3D-gestapeltes Flächendiagramm dar |
| Area3D100PercentStacked | Stellt ein 3D-100 %-gestapeltes Flächendiagramm dar |
| Doughnut | Stellt ein Doughnut-Diagramm dar |
| DoughnutExploded | Stellt ein explodiertes Doughnut-Diagramm dar |
| Radar | Stellt das Radar-Diagramm dar |
| RadarWithDataMarkers | Stellt das Radar-Diagramm mit Datenmarkierungen dar |
| RadarFilled | Stellt ein gefülltes Radar-Diagramm dar |
| Surface3D | Stellt ein 3D-Oberflächendiagramm dar |
| SurfaceWireframe3D | Stellt das 3D-Netzflächendiagramm dar |
| SurfaceContour | Stellt Konturdiagramm dar |
| SurfaceContourWireframe | Stellt Drahtgitter-Konturdiagramm dar |
| Bubble | Stellt Blasendiagramm dar |
| Bubble3D | Stellt 3D-Blasendiagramm dar |
| Cylinder | Stellt Zylinderdiagramm dar |
| CylinderStacked | Stellt gestapeltes Zylinderdiagramm dar |
| Cylinder100PercentStacked | Stellt 100 % gestapeltes Zylinderdiagramm dar |
| CylindricalBar | Stellt ein zylindrisches Balkendiagramm dar |
| CylindricalBarStacked | Stellt ein gestapeltes zylindrisches Balkendiagramm dar |
| CylindricalBar100PercentStacked | Stellt ein zu 100 % gestapeltes zylindrisches Balkendiagramm dar |
| CylindricalColumn3D | Stellt ein 3D-zylindrisches Säulendiagramm dar |
| Cone | Stellt Kegeldiagramm dar |
| ConeStacked | Stellt gestapeltes Kegeldiagramm dar |
| Cone100PercentStacked | Stellt 100 % gestapeltes Kegeldiagramm dar |
| ConicalBar | Stellt konisches Balkendiagramm dar |
| ConicalBarStacked | Stellt gestapeltes konisches Balkendiagramm dar |
| ConicalBar100PercentStacked | Stellt 100 % gestapeltes konisches Balkendiagramm dar |
| ConicalColumn3D | Stellt 3D-konisches Säulendiagramm dar |
| Pyramid | Stellt Pyramiden-Diagramm dar |
| PyramidStacked | Stellt gestapeltes Pyramiden-Diagramm dar |
| Pyramid100PercentStacked | Stellt 100% gestapeltes Pyramidendiagramm dar |
| PyramidBar | Stellt das Pyramid-Balkendiagramm dar |
| PyramidBarStacked | Stellt gestapeltes Pyramidensäulendiagramm dar |
| PyramidBar100PercentStacked | Stellt 100% gestapeltes Pyramidensäulendiagramm dar |
| PyramidColumn3D | Stellt 3D-Pyramiden-Säulendiagramm dar |
| Um ein Diagramm mit Aspose.Cells zu erstellen: |
- Fügen Sie einige Daten zu Arbeitsblattzellen mit der Cell-Methode des Objekts setValue hinzu. Dies wird als Datenquelle für das Diagramm verwendet.
- Fügen Sie ein Diagramm zum Arbeitsblatt hinzu, indem Sie die Methode add der Sammlung ChartCollection aufrufen, die im Objekt Worksheet verkapselt ist.
- Geben Sie mit der ChartType-Aufzählung den Diagrammtyp an. Beispielsweise verwendet das Beispiel den Wert ChartType.PYRAMID als Diagrammtyp.
- Greifen Sie über die Indexübergabe auf das neue Chart-Objekt aus der ChartCollection-Sammlung zu.
- Verwenden Sie eines der im Chart-Objekt eingeschlossenen Diagrammobjekte, um das Diagramm zu verwalten. Das untenstehende Beispiel verwendet das SeriesCollection-Diagrammobjekt, um die Datenquelle des Diagramms anzugeben.
Beim Hinzufügen von Quelldaten zum Diagramm kann die Datenquelle ein Zellenbereich (z. B. “A1:C3”) oder eine Sequenz von nicht zusammenhängenden Zellen (z. B. “A1, A3, A5”) oder eine Sequenz von Werten (z. B. “1,2,3”) sein.
Diese allgemeinen Schritte ermöglichen es Ihnen, beliebige Arten von Diagrammen zu erstellen. Verwenden Sie verschiedene Diagrammobjekte, um verschiedene Diagramme zu erstellen.
Wenn der Beispielcode ausgeführt wird, wird ein Pyramiden-Diagramm wie unten gezeigt zum Arbeitsblatt hinzugefügt.
Pyramiden-Diagramm mit seiner Datenquelle
Um ein Bubbel-Diagramm zu erstellen, muss das ChartType auf ChartType.BUBBLE gesetzt werden, und einige zusätzliche Eigenschaften wie BubbleSizes, Values & XValues müssen entsprechend gesetzt werden. Nach Ausführung des folgenden Codes wird ein Bubbel-Diagramm wie unten gezeigt zum Arbeitsblatt hinzugefügt.
Bubbel-Diagramm mit seiner Datenquelle
Liniendiagramm mit Datenmarkierungen
Um ein Linie mit Datenmarkern-Diagramm zu erstellen, muss das ChartType auf ChartType.LINE_WITH_DATA_MARKERS gesetzt werden und einige zusätzliche Eigenschaften wie Hintergrundbereich, Serienmarker, Werte & X-Werte entsprechend gesetzt werden. Nach Ausführung des folgenden Codes wird ein Linie mit Datenmarkern-Diagramm zum Arbeitsblatt hinzugefügt.
Erstellen von benutzerdefinierten Diagrammen
Bisher haben wir, wenn wir über Diagramme gesprochen haben, Standarddiagramme betrachtet, die ihre eigenen Formatierungseinstellungen haben. Wir definieren nur die Datenquelle, setzen einige Eigenschaften und das Diagramm wird mit seinen Standardformatierungseinstellungen erstellt. Aber Aspose.Cells unterstützt auch die Erstellung benutzerdefinierter Diagramme, die es Entwicklern ermöglichen, Diagramme mit ihren eigenen Formatierungseinstellungen zu erstellen.
Erstellen von benutzerdefinierten Diagrammen
Entwickler können mithilfe der einfachen Aspose.Cells-API benutzerdefinierte Diagramme zur Laufzeit erstellen.
Ein Diagramm besteht aus einer Datenreihe. Jede Datenreihe in Aspose.Cells wird durch ein Series-Objekt repräsentiert, während das SeriesCollection-Objekt als Sammlung von Series-Objekten dient. Bei der Erstellung eines benutzerdefinierten Diagramms haben Entwickler die Freiheit, verschiedene Arten von Diagrammen für verschiedene Datenreihen (gesammelt in einem Objekt) zu verwenden.
Der nachstehende Beispielcode zeigt, wie benutzerdefinierte Diagramme erstellt werden können. 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 ein Säulendiagramm, kombiniert mit einem Liniendiagramm, dem Arbeitsblatt hinzufügen.
Benutzerdefiniertes Diagramm, das Säulen- und Liniendiagramme kombiniert
Programmierbeispiel