Sparklines in Aspose.Cells for Python via .NET

Aspose.Cells unterstützt das Erstellen von Sparklines innerhalb von Arbeitsblattzellen. Sparklines sind Miniaturdiagramme, die in eine einzelne Zelle passen und eine schnelle visuelle Darstellung von Datentrends bieten. Aspose.Cells unterstützt Linien-, Spalten- und Gewinn/Verlust-Sparklines, und jede kann hinsichtlich Farbe, Linienstärke, Hoch-/Tiefpunkten und Markierungen angepasst werden.

Einführung

Sparklines sind winzige Diagramme innerhalb von Zellen, die nützlich sind, wenn Sie einen schnellen Trend neben einer Datenreihe oder -spalte anzeigen möchten, ohne den Platz eines vollständigen Diagramms einzunehmen. Excel unterstützt drei Arten von Sparklines: Linie, Spalte und Gewinn/Verlust. Aspose.Cells spiegelt diese Funktionalität durch die SparklineGroup- und SparklineGroupCollection-APIs wider, die sich im Namespace aspose.cells.charts befinden. In Aspose.Cells wird jede Sparkline, die Sie hinzufügen, durch worksheet.sparkline_groups.add(...) erstellt, die ein SparklineGroup-Objekt zurückgibt. Sie können dieses Objekt dann verwenden, um den Sparkline-Typ, den Datenbereich, die Zielzelle und visuelle Eigenschaften wie Linienfarbe, Linienstärke, Markierungen sowie Hoch-/Tiefpunkt-Indikatoren festzulegen. Dieser Artikel führt durch jede der drei von Aspose.Cells unterstützten Sparkline-Typen — Linie, Spalte und Gewinn/Verlust — und zeigt, wie sie hinzugefügt, in ihren Farben angepasst und die resultierende Arbeitsmappe gespeichert werden.

Linien-Sparklines

Eine Linien-Sparkline zeichnet eine durchgehende Linie durch die Datenpunkte einer Reihe und ist damit die natürlichste Wahl, um Trends im Zeitverlauf darzustellen. In Aspose.Cells wird eine Linien-Sparkline erstellt, indem SparklineType.Line an die Methode sparkline_groups.add übergeben wird.

Erstellen Sie eine neue Workbook und greifen Sie auf das erste Arbeitsblatt zu.
Befüllen Sie eine Datenreihe (zum Beispiel Zeile 1, Spalten A bis E) mit den Werten, die Sie visualisieren möchten.
Erstellen Sie eine CellArea, die die Zielzelle beschreibt, in der die Sparkline gezeichnet wird.
Rufen Sie worksheet.sparkline_groups.add(SparklineType.Line, "A1:E1", False, dest) auf. Das dritte Argument — False — teilt Aspose.Cells mit, dass der Datenbereich horizontal (eine Zeile) und nicht vertikal (eine Spalte) ist.
Passen Sie optional die zurückgegebene SparklineGroup an. Für eine Linien-Sparkline können Sie die Linienfarbe mit group.line.color festlegen (die eine CellsColor aus aspose.cells.drawing erwartet), die Linienstärke anpassen und Markierungen für Hoch-/Tiefpunkte umschalten.
Speichern Sie die Arbeitsmappe. Das folgende Beispiel erstellt eine Arbeitsmappe, schreibt die Werte 5, -3, 8, -2, 6 in die Zellen A1 bis E1 und fügt in Zelle F1 eine Linien-Sparkline hinzu, die diese Werte nachzeichnet. Es passt außerdem die Linienfarbe auf Rot an und aktiviert Markierungen für die Hoch- und Tiefpunkte.

import aspose.cells as ac
import System.Drawing
# Step 1: Create a Workbook and get the first worksheet
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
worksheet.name = "WinLoss"
# Step 2: Populate sample data in row 1: A1=5, B1=-3, C1=8, D1=-2, E1=6
worksheet.cells["A1"].put_value(5)
worksheet.cells["B1"].put_value(-3)
worksheet.cells["C1"].put_value(8)
worksheet.cells["D1"].put_value(-2)
worksheet.cells["E1"].put_value(6)
# Step 3: Build a CellArea pointing to F1 (column 5, row 0)
dest = ac.CellArea()
dest.start_column = 5   # F
dest.end_column = 5
dest.start_row = 0      # row 1
dest.end_row = 0
# Step 4: Add a Win/Loss sparkline (SparklineType.Stacked)
group_index = worksheet.sparkline_groups.add(
    ac.SparklineType.Stacked,
    "A1:E1",
    False,
    dest)
group = worksheet.sparkline_groups[group_index]
# Step 5: Customize the sparkline group
# Enable high-point and low-point markers
group.show_high_point = True
group.show_low_point = True
group.show_negative_points = True
# Set the high-point color to green
high_color = workbook.create_cells_color()
high_color.color = System.Drawing.Color.Green
group.high_point_color = high_color
# Set the low-point color to red
low_color = workbook.create_cells_color()
low_color.color = System.Drawing.Color.Red
group.low_point_color = low_color
# Set the negative-point color to orange
neg_color = workbook.create_cells_color()
neg_color.color = System.Drawing.Color.Orange
group.negative_points_color = neg_color
# Set the default series color (used for positive bars)
series_color = workbook.create_cells_color()
series_color.color = System.Drawing.Color.SteelBlue
group.series_color = series_color
# Step 6: Save the workbook
workbook.save("output_winloss.xlsx")
print("Workbook saved successfully: output_winloss.xlsx")

Spalten-Sparklines

Eine Spalten-Sparkline stellt jeden Datenpunkt als vertikalen Balken dar. Dadurch eignet sie sich besonders gut für Daten, deren Größe aussagekräftig ist — zum Beispiel monatliche Verkaufszahlen oder Zählungen. In Aspose.Cells erstellen Sie eine Spalten-Sparkline, indem Sie SparklineType.Column an die Methode sparkline_groups.add übergeben. Die Vorgehensweise spiegelt das Beispiel der Linien-Sparkline wider:

Erstellen Sie eine neue Workbook und greifen Sie auf das erste Arbeitsblatt zu.
Erstellen Sie eine CellArea, die die Zielzelle beschreibt.
Rufen Sie worksheet.sparkline_groups.add(SparklineType.Column, "A1:E1", False, dest) auf.
Passen Sie optional die resultierende SparklineGroup an — zum Beispiel durch Setzen von group.type, um den Typ zu bestätigen, oder durch Anpassen der Balkenfarbe.
Speichern Sie die Arbeitsmappe in einer separaten Ausgabedatei, damit das Beispiel der Linien-Sparkline nicht überschrieben wird. Das folgende Beispiel schreibt die Werte 5, -3, 8, -2, 6 in A1:E1 und rendert eine Spalten-Sparkline in F1. Negative Werte werden als nach unten verlaufende Balken und positive Werte als nach oben verlaufende Balken dargestellt, wodurch positive und negative Beiträge leicht auf einen Blick erkennbar sind.

import aspose.cells as ac
# Schritt 1: Erstellen Sie eine Arbeitsmappe und holen Sie sich das erste Arbeitsblatt
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
# Schritt 2: Schreiben Sie Beispielwerte in A1:E1
values = [5, -3, 8, -2, 6]
for i in range(len(values)):
    worksheet.cells[0, i].put_value(values[i])
# Schritt 3: Erstellen Sie einen CellArea, der auf F1 zeigt (Spaltenindex 5, Zeilenindex 0)
dest = ac.CellArea()
dest.start_column = 5
dest.end_column = 5
dest.start_row = 0
dest.end_row = 0
# Schritt 4: Fügen Sie eine Spalten-Sparkline zur Zielzelle hinzu
idx = worksheet.sparkline_groups.add(
    ac.SparklineType.COLUMN, "A1:E1", False, dest)
group = worksheet.sparkline_groups[idx]
# Schritt 5: Bestätigen Sie den Sparkline-Typ durch Lesen von group.Type
print("Sparkline Type added: " + str(group.type))
# Schritt 6: Speichern Sie die Arbeitsmappe
workbook.save("output_column.xlsx")
print("Workbook saved as output_column.xlsx")

Gewinn/Verlust-Sparklines

Eine Gewinn/Verlust-Sparkline ist eine spezielle Variante der Spalten-Sparkline, die nur zwei Ergebnisse anzeigt: Ein positiver Wert wird als „Aufwärts"-Balken (ein Gewinn) und ein Null- oder negativer Wert als „Abwärts"-Balken (ein Verlust) dargestellt. Gewinn/Verlust-Sparklines werden häufig verwendet, um Sequenzen von Gewinnen und Verlusten, Bestehens-/Nichtergebnisse oder beliebige binäre Ergebnisse im Zeitverlauf zu visualisieren. In Aspose.Cells wird eine Gewinn/Verlust-Sparkline erstellt, indem SparklineType.Stacked an die Methode sparkline_groups.add übergeben wird. (Trotz des Namens ist SparklineType.Stacked der Enum-Wert, der verwendet wird, um das Gewinn/Verlust-Rendering anzufordern.)

Erstellen Sie eine neue Workbook und greifen Sie auf das erste Arbeitsblatt zu.
Befüllen Sie den Quellbereich. Da Gewinn/Verlust-Sparklines jeden Wert entweder als Gewinn oder Verlust behandeln, ist die Größe des Werts nicht entscheidend — nur sein Vorzeichen. Positive Werte werden zu Aufwärtsbalken und nicht-positive Werte zu Abwärtsbalken.
Erstellen Sie eine CellArea, die die Zielzelle beschreibt.
Rufen Sie worksheet.sparkline_groups.add(SparklineType.Stacked, "A1:E1", False, dest) auf.
Passen Sie optional die zurückgegebene SparklineGroup an, zum Beispiel durch Setzen von Akzentfarben für die Gewinn- und Verlust-Balken.
Speichern Sie die Arbeitsmappe unter einem eindeutigen Dateinamen, damit alle drei Beispiele nebeneinander auf der Festplatte existieren können.

import aspose.cells as ac
import System.Drawing
# Step 1: Create a Workbook and get the first worksheet
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
cells = worksheet.cells
# Step 2: Write sample values 5, -3, 8, -2, 6 into cells A1:E1
cells["A1"].put_value(5)
cells["B1"].put_value(-3)
cells["C1"].put_value(8)
cells["D1"].put_value(-2)
cells["E1"].put_value(6)
# Step 3: Build a CellArea pointing to destination cell F1
dest = ac.CellArea()
dest.start_column = 5   # column F (0-indexed)
dest.end_column = 5
dest.start_row = 0      # row 1 (0-indexed)
dest.end_row = 0
# Step 4: Add a Line sparkline from A1:E1 into F1
# SparklineGroups.Add returns the index of the newly added group
index = worksheet.sparkline_groups.add(ac.SparklineType.LINE, "A1:E1", False, dest)
group = worksheet.sparkline_groups[index]
# Step 5: Create a red CellsColor and assign it to the sparkline line color
red = workbook.create_cells_color()
red.color = System.Drawing.Color.Red
group.series_color = red
# Step 6: Enable high-point and low-point markers
group.show_high_point = True
group.show_low_point = True
# Step 7: Save the workbook
workbook.save("output_line.xlsx")

Kombinieren aller drei Sparkline-Typen

Das folgende kombinierte Beispiel erstellt eine einzelne Arbeitsmappe, befüllt Zeile 1 mit den Werten 5, -3, 8, -2, 6 und fügt dann drei Sparkline-Gruppen in den Zellen F1, F2 und F3 hinzu — eine von jedem Typ — sodass die resultierende Datei alle drei Sparkline-Stile gleichzeitig demonstriert.

import aspose.cells as ac
import System.Drawing
# Schritt 1: Erstellen Sie eine Arbeitsmappe und holen Sie sich das erste Arbeitsblatt
workbook = ac.Workbook()
worksheet = workbook.worksheets[0]
# Schritt 2: Füllen Sie Beispieldaten in Zeile 1 (A1:E1)
worksheet.cells["A1"].put_value(5)
worksheet.cells["B1"].put_value(-3)
worksheet.cells["C1"].put_value(8)
worksheet.cells["D1"].put_value(-2)
worksheet.cells["E1"].put_value(6)
# Schritt 3: Fügen Sie eine Linien-Sparkline-Gruppe bei F1 hinzu
line_area = ac.CellArea()
line_area.start_column = 5
line_area.end_column = 5
line_area.start_row = 0
line_area.end_row = 0
line_idx = worksheet.sparkline_groups.add(ac.SparklineType.LINE, "A1:E1", False, line_area)
line_group = worksheet.sparkline_groups[line_idx]
# Passen Sie die Farbe der Linien-Sparkline über CellsColor an
line_color = workbook.create_cells_color()
line_color.color = System.Drawing.Color.Blue
line_group.series_color = line_color
# Schritt 4: Fügen Sie eine Spalten-Sparkline-Gruppe bei F2 hinzu
column_area = ac.CellArea()
column_area.start_column = 5
column_area.end_column = 5
column_area.start_row = 1
column_area.end_row = 1
column_idx = worksheet.sparkline_groups.add(ac.SparklineType.COLUMN, "A1:E1", False, column_area)
column_group = worksheet.sparkline_groups[column_idx]
# Passen Sie die Serienfarbe der Spalten-Sparkline an
column_color = workbook.create_cells_color()
column_color.color = System.Drawing.Color.Green
column_group.series_color = column_color
# Schritt 5: Fügen Sie eine Gewinn/Verlust (gestapelte) Sparkline-Gruppe bei F3 hinzu
stacked_area = ac.CellArea()
stacked_area.start_column = 5
stacked_area.end_column = 5
stacked_area.start_row = 2
stacked_area.end_row = 2
stacked_idx = worksheet.sparkline_groups.add(ac.SparklineType.STACKED, "A1:E1", False, stacked_area)
stacked_group = worksheet.sparkline_groups[stacked_idx]
# Passen Sie die Serienfarbe der Gewinn/Verlust-Sparkline an
stacked_color = workbook.create_cells_color()
stacked_color.color = System.Drawing.Color.DarkOrange
stacked_group.series_color = stacked_color
# Schritt 6: Speichern Sie die Arbeitsmappe
workbook.save("output_all.xlsx")

Anpassen des Sparkline-Erscheinungsbilds

Sobald eine SparklineGroup erstellt und zu worksheet.sparkline_groups hinzugefügt wurde, können Sie mehrere ihrer visuellen Eigenschaften lesen oder ändern, bevor Sie die Arbeitsmappe speichern. Die am häufigsten angepassten Eigenschaften sind:

group.type — der SparklineType (Line, Column oder Stacked). Er wird beim Hinzufügen der Gruppe festgelegt, aber Sie können ihn zur Bestätigung wieder auslesen.
group.line.color — die Linienfarbe, ausgedrückt als CellsColor, erstellt über workbook.create_cells_color(). Dies ist die Eigenschaft, die für die Strichfarbe der Linien-Sparkline verwendet wird.
group.line.weight — die Linienstärke in Punkten. Höhere Werte erzeugen dickere Linien.
Hoch-/Tiefpunkt-Markierungen — Flags, die kleine Markierungen an den höchsten und niedrigsten Datenpunkten einschalten, nützlich zur Hervorhebung von Extremwerten.
Markierungen für erste/letzte/negative Punkte — Flags, die Markierungen an den ersten, letzten und negativen Datenpunkten umschalten. Um eine Farbe zu ändern, erstellen Sie immer eine CellsColor-Instanz und weisen sie der entsprechenden Eigenschaft zu. Sparkline-Farbeigenschaften erwarten den Typ CellsColor aus aspose.cells.drawing — weisen Sie ihnen keinen Roh-Farbwert direkt zu. Die Methode sparkline_groups.add selbst gibt ein vollständig typisiertes SparklineGroup-Objekt zurück, sodass Sie Eigenschaftszuweisungen am Rückgabewert verketten oder es in einer lokalen Variablen speichern und vor dem Speichern anpassen können.

Intelligentes Importieren und Platzieren von Daten mit intelligenten Markern in Python über .Net VBA Codes einer Excel Makro aktivierten Arbeitsmappe verwalten.