Arbeiten mit Diagrammen
Der DocumentBuilder-Klasse wurde eine neue InsertChart-Methode hinzugefügt. Sehen wir uns also an, wie man mit der InsertChart-Methode ein einfaches Säulendiagramm in das Dokument einfügt.
So fügen Sie ein Diagramm ein
In diesem Abschnitt erfahren Sie, wie Sie ein Diagramm in ein Dokument einfügen.
Säulendiagramm einfügen
Das folgende Codebeispiel zeigt, wie man ein Säulendiagramm einfügt:
Der Code erzeugt das folgende Ergebnis:
Es gibt vier verschiedene Überladungen für die Add-Methode der Serie, die bereitgestellt wurde, um alle möglichen Varianten von Datenquellen für alle Diagrammtypen abzudecken:
Der Code erzeugt das folgende Ergebnis:
Streudiagramm einfügen
Das folgende Codebeispiel zeigt, wie ein Streudiagramm eingefügt wird:
Der Code erzeugt das folgende Ergebnis:
Flächendiagramm einfügen
Das folgende Codebeispiel zeigt, wie ein Flächendiagramm eingefügt wird:
Der Code erzeugt das folgende Ergebnis:
Blasendiagramm einfügen
Das folgende Codebeispiel zeigt, wie man ein Blasendiagramm einfügt:
Der Code erzeugt das folgende Ergebnis:
Arbeiten mit Diagrammen über Shape.Chart-Objekt
Sobald das Diagramm eingefügt und mit Daten gefüllt wurde, können Sie sein Erscheinungsbild ändern. Die Shape.Chart-Eigenschaft enthält alle diagrammbezogenen Optionen, die über das öffentliche API verfügbar sind.
Lassen Sie uns beispielsweise das Verhalten des Diagrammtitels oder der Legende ändern:
Der Code generiert die folgenden Ergebnisse:
So arbeiten Sie mit ChartSeriesCollection of Chart
Schauen wir uns die ChartSeries-Sammlung an. Alle Diagrammreihen sind über die chart.Series-Sammlung verfügbar, bei der es sich um IEnumerable handelt:
Sie können Serien einzeln oder alle löschen und bei Bedarf eine neue hinzufügen. Dem neu eingefügten Diagramm wurden dieser Sammlung einige Standardreihen hinzugefügt. Um sie zu entfernen, müssen Sie die chart.Series.Clear()-Methode aufrufen.
Arbeiten mit der Single ChartSeries-Klasse
So arbeiten Sie mit einer bestimmten Serie:
Bitte sehen Sie sich das Ergebnis unten an:
Alle einzelnen ChartSeries-Dateien verfügen über standardmäßige ChartDataPoint-Optionen. Versuchen Sie bitte, diese mit dem folgenden Code zu ändern:
Bitte sehen Sie sich das Ergebnis unten an:
So arbeiten Sie mit einem einzelnen ChartDataPoint eines ChartSeries
Mit ChartDataPoint können Sie die Formatierung eines einzelnen Datenpunkts der Diagrammreihe anpassen:
Bitte sehen Sie sich das Ergebnis unten an:
So arbeiten Sie mit ChartDataLabel einer einzelnen ChartSeries
Mit ChartDataLabel können Sie die Formatierung einer einzelnen Datenbeschriftung der Diagrammreihe festlegen, z. B. LegendKey, CategoryName, SeriesName, Value usw. ein-/ausblenden:
Bitte sehen Sie sich das Ergebnis unten an:
So definieren Sie Standardoptionen für ChartDataLabels von ChartSeries
Die ChartDataLabelCollection-Klasse definiert Eigenschaften, die zum Festlegen von Standardoptionen für ChartDataLabels für Diagramm-Series verwendet werden können. Zu diesen Eigenschaften gehören ShowCategoryName, ShowBubbleSize, ShowPercentage, ShowSeriesName, ShowValue usw.:
Bitte sehen Sie sich das Ergebnis unten an:
So formatieren Sie die Nummer der Diagrammdatenbeschriftung
Mit NumberFormat können Sie die Zahlenformatierung einer einzelnen Datenbeschriftung des Diagramms festlegen.
Das folgende Codebeispiel zeigt, wie eine Nummer der Datenbeschriftung formatiert wird:
So legen Sie die Eigenschaften der Diagrammachse fest
Wenn Sie mit Diagrammachsen, Skalierungen und Anzeigeeinheiten für die Werteachse arbeiten möchten, verwenden Sie bitte die Klassen ChartAxis, AxisDisplayUnit und AxisScaling.
Das folgende Codebeispiel zeigt, wie X- und Y-Achseneigenschaften definiert werden:
So legen Sie den Date-Zeitwert der Achse fest
Das folgende Codebeispiel zeigt, wie Datums-/Uhrzeitwerte für Achseneigenschaften festgelegt werden:
So formatieren Sie den Zahlenwert einer Achse
Das folgende Codebeispiel zeigt, wie Sie das Format von Zahlen auf der Werteachse ändern:
So legen Sie Achsengrenzen fest
Die AxisBound-Klasse stellt eine minimale oder maximale Grenze von Achsenwerten dar. Bound kann als numerischer Wert, Datum-Uhrzeit-Wert oder spezieller “Auto”-Wert angegeben werden.
Das folgende Codebeispiel zeigt, wie Grenzen einer Achse festgelegt werden:
So legen Sie die Intervalleinheit zwischen Etiketten fest
Das folgende Codebeispiel zeigt, wie die Intervalleinheit zwischen Beschriftungen auf einer Achse festgelegt wird:
So blenden Sie die Diagrammachse aus
Wenn Sie die Diagrammachse ein- oder ausblenden möchten, können Sie dies einfach erreichen, indem Sie den Wert der ChartAxis.Hidden-Eigenschaft festlegen.
Das folgende Codebeispiel zeigt, wie Sie die Y-Achse des Diagramms ausblenden:
So richten Sie die Diagrammbeschriftung aus
Wenn Sie eine Textausrichtung für mehrzeilige Beschriftungen festlegen möchten, können Sie dies einfach durch Festlegen des Werts der TickLabels.Ausrichtung-Eigenschaft erreichen.
Das folgende Codebeispiel zeigt, wie die Beschriftungsausrichtung aktiviert wird:
So legen Sie die Füll- und Strichformatierung fest
Füll- und Strichformatierungen können für Diagrammreihen, Datenpunkte und Markierungen festgelegt werden. Dazu müssen Sie die Eigenschaften des ChartFormat-Typs in den ChartSeries-, ChartDataPoint- und ChartMarker-Klassen sowie Aliase für einige Eigenschaften wie ForeColor, BackColor, Visible und Transparency in der Stroke-Klasse verwenden.
Das folgende Codebeispiel zeigt, wie die Serienfarbe festgelegt wird:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Column, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Create category names array.
string[] categories = new string[] { "AW Category 1", "AW Category 2" };
// Adding new series. Value and category arrays must be the same size.
ChartSeries series1 = seriesColl.Add("AW Series 1", categories, new double[] { 1, 2 });
ChartSeries series2 = seriesColl.Add("AW Series 2", categories, new double[] { 3, 4 });
ChartSeries series3 = seriesColl.Add("AW Series 3", categories, new double[] { 5, 6 });
// Set series color.
series1.Format.Fill.ForeColor = Color.Red;
series2.Format.Fill.ForeColor = Color.Yellow;
series3.Format.Fill.ForeColor = Color.Blue;
doc.Save(dir + "ColumnColor.docx");
Das folgende Codebeispiel zeigt, wie Sie Linienfarbe und -stärke festlegen:
Document doc = new Document();
DocumentBuilder builder = new DocumentBuilder(doc);
Shape shape = builder.InsertChart(ChartType.Line, 432, 252);
Chart chart = shape.Chart;
ChartSeriesCollection seriesColl = chart.Series;
// Delete default generated series.
seriesColl.Clear();
// Adding new series.
ChartSeries series1 = seriesColl.Add("AW Series 1", new double[] { 0.7, 1.8, 2.6 },
new double[] { 2.7, 3.2, 0.8 });
ChartSeries series2 = seriesColl.Add("AW Series 2", new double[] { 0.5, 1.5, 2.5 },
new double[] { 3, 1, 2 });
// Set series color.
series1.Format.Stroke.ForeColor = Color.Red;
series1.Format.Stroke.Weight = 5;
series2.Format.Stroke.ForeColor = Color.LightGreen;
series2.Format.Stroke.Weight = 5;
doc.Save(dir + "LineColorAndWeight.docx");