Syntax

	excelCell(content: $content, row: $row, col: $col, style: $cellStyle)

Beschreibung

Erstellt eine einzelne Zelle mit spezifischer Position, Inhalt und Formatierung. Diese Funktion wird innerhalb von excelSheet() verwendet, um präzise Kontrolle über die Platzierung und das Erscheinungsbild von Zellen zu erhalten.

Die Funktion unterstützt verschiedene Inhaltstypen (Text, Zahlen, Boolean, Formeln) und umfassende Formatierungsoptionen wie Schriftarten, Farben, Rahmen, Ausrichtung und Zahlenformate.

Parameter

Name	Typ	Beschreibung	Pflicht	Default
content	Objekt	Der Inhalt der Zelle. Dies kann Text, Zahlen, Boolean-Werte, eine Excel-Formel (erzeugt mit excelFormula()) oder eine verschachtelte Liste von Zellen sein.	ja
row	Zahl	Die Zeilennummer der Zelle (0-basiert). Wenn nicht angegeben, wird die aktuelle Cursor-Position verwendet.	nein	null
col	Zahl	Die Spaltennummer der Zelle (0-basiert). Wenn nicht angegeben, wird die aktuelle Cursor-Position verwendet.	nein	null
style	ExcelStyle	Ein mit excelStyle() erstelltes Stilobjekt.	nein	null

Rückgabewert

Typ: Map

Ein Map-Objekt, das die Zelleninformationen für die Verarbeitung durch excelSheet() enthält.

Beispiele

Einfache Zelle mit Textinhalt

	excelCell(row: 0, col: 0, content: "Hello World")

Ausgabe: Zelle in Zeile 0, Spalte 0 mit dem Text "Hello World". Die aktuelle Cursor-Position nach diesem Ausdruck wäre: Row 0, Col 1.

Zelle mit Zahlenformatierung

	excelCell(row: 1, col: 1, content: 1250.50,
          style: excelStyle(numberFormat: "$#,##0.00", align: "right"))

Ausgabe: Zelle mit Währungsformat: "$1,250.50", rechtsbündig ausgerichtet.

Zelle mit umfassender Formatierung

	excelCell(row: 3, col: 0, content: "Wichtiger Hinweis",
	style: {
		"bold": true,
		"italic": true,
		"color": "#DC3545",
		"background": "#F8D7DA",
		"fontSize": 12,
		"borderTop": "medium",
		"borderBottom": "medium",
		"borderLeft": "medium",
		"borderRight": "medium",
		"align": "center",
		"valign": "center"
	})

Ausgabe: Rote, fett-kursive Schrift auf hellem Rot-Hintergrund mit Rahmen und zentrierter Ausrichtung.

Zelle mit Excel-Formel

	excelCell(row: 5, col: 2, content: excelFormula("SUM(A5:A10)"),
          style: excelStyle(numberFormat: "$#,##0.00", bold: true, background: "#E8F5E8"))

Ausgabe: Zelle mit Excel-Formel, die die Summe von Zellen A5 bis A10 berechnet, mit Währungsformat und grünem Hintergrund.

Wiederverwendbare Stile

	// Stildefinition
headerStyle = excelStyle(
  bold: true,
  background: "#007BFF",
  color: "white",
  align: "center",
  borderBottom: "thick"
);

// Anwendung des Stils
excelCell(row: 0, col: 0, content: "Produkt", style: $headerStyle)
excelCell(row: 0, col: 1, content: "Preis", style: $headerStyle)
excelCell(row: 0, col: 2, content: "Bestand", style: $headerStyle)

Ausgabe: Drei Kopfzellen mit einheitlichem blauen Header-Stil.

Zellen mit Cursor-basierter Positionierung

	// Zellen werden automatisch platziert (Cursor-Modus)
excelCell(content: "Produkt")           // row: 0, col: 0
excelCell(content: "Preis")             // row: 0, col: 1
excelCell(content: "Bestand")           // row: 0, col: 2

excelCell(content: "Widget A")          // row: 1, col: 0
excelCell(content: 29.99)               // row: 1, col: 1
excelCell(content: 150)                 // row: 1, col: 2

// Manuelle Positionierung für Überschrift
excelCell(row: 3, col: 0, content: "Gesamtsumme", style: excelStyle(bold: true))
excelCell(row: 3, col: 1, content: excelFormula("SUM(B2:B4)"), style: excelStyle(numberFormat: "$#,##0.00"))

Ausgabe: Tabelle mit automatischer Platzierung für Datenzellen und manueller Positionierung für die Summenzeile.

Verschachtelte Tabellen (excelCell als Inhalt)

	// Hauptzelle mit verschachtelter Tabelle
excelCell(
  row: 0,
  col: 0,
  content: [
    ["Detail A", "Detail B", "Detail C"],
    [100, 200, 300],
    [150, 250, 350]
  ],
  style: excelStyle(
    borderTop: "thick",
    borderBottom: "thick",
    borderLeft: "thick",
    borderRight: "thick"
  )
)

// Zelle mit verschachtelten, formatierten Zellen
excelCell(
  row: 5,
  col: 0,
  content: [
    excelCell(content: "Header", style: excelStyle(bold: true, background: "#E8F5E8")),
    excelCell(content: "Value", style: excelStyle(numberFormat: "#,##0.00", align: "right"))
  ]
)

Ausgabe: Zellen, die selbst kleine Tabellen oder formatierte Zellgruppen enthalten.