Bezeichnung
xlsx.SetCellValue -- setzt den Zellenwert
Übersicht
xlsx.SetCellValue(id, x, y, val[, type, sheet])
xlsx.SetCellValue(id, ref, val[, type, sheet])
Beschreibung
Dieser Befehl setzt den Wert der angegebenen Zelle auf den in val angegebenen Wert. Es gibt zwei Möglichkeiten, die Zelle anzugeben, deren Wert festgelegt werden soll: Sie können die zu verwendende Zelle entweder angeben, indem Sie die Spalten- (x) und Zeilenposition (y) der Zelle in den Argumenten x und y übergeben. Diese Positionen beginnen bei 1 für die erste Spalte und Zeile. Alternativ können Sie die Zelle auch angeben, indem Sie ihre Position im Parameter ref übergeben. Dies kann entweder eine Zeichenkette sein, z.B. "A10" für die erste Zelle in der 10. Zeile oder ein Iteratorreferenz, die vom Befehl xlsx.CellRange() zurückgegeben wird. Optional können Sie auch den Index des zu verwendenden Arbeitsblatts im optionalen Parameter sheet übergeben (beginnend mit 1 für das erste Arbeitsblatt). Wenn der Parameter sheet weggelassen wird, wird das mit xlsx.SetDefaultSheet() eingestellte Arbeitsblatt verwendet.

Optional können Sie auch den Werttyp im Argument type angeben. Normalerweise ist dies nicht notwendig, da xlsx.SetCellValue() den Werttyp anhand des Typs des in val übergebenen Arguments bestimmt. Aber da Hollywood nicht zwischen booleschen, ganzzahligen und Fließkommawerten unterscheidet, ist dies möglicherweise erforderlich. Übergeben Sie den Parameter type, um sicherzustellen, dass die Zelle auf den gewünschten Typ eingestellt wird. Der Parameter type kann eine der folgenden speziellen Konstanten sein:

#INTEGER
Eine Ganzzahl.

#DOUBLE
Ein Fließkommawert.

#STRING
Ein Zeichenkettenwert.

#BOOLEAN
Ein boolescher Wert (entweder True oder False).

#NIL
Die Zelle ist leer.

Beachten Sie, dass es beim Versuch, die Werte vieler Zellen zu setzen, normalerweise viel schneller ist, den Befehl xlsx.CellRange() zusammen mit einer generischen For-Schleife zu verwenden, um die gewünschten Zellen zu durchlaufen. Dies wird besonders empfohlen, wenn es sich um große XLSX-Dokumente mit Tausenden von Zellen handelt.

Eingaben
id
ID des zu verwendenden XLSX-Dokuments
x
Spaltenindex der zu verwendenden Zelle (beginnend bei 1)
y
Zeilenindex der zu verwendenden Zelle (beginnend bei 1)
ref
Zellposition (z.B. "A1" oder ein Iteratorreferenz),
val
gewünschter Zellenwert
type
optional: Typ des Wertes (mögliche Konstanten siehe oben)
sheet
optional: Index des zu verwendenden Arbeitsblatts (standardmäßig der Index des Standardarbeitsblatts)
Beispiel
xlsx.Create(1, "test.xlsx")
For Local y = 1 To 100
   For Local x = 1 to 30
      xlsx.SetCellValue(1, x, y, "Cell " .. x .. "/" .. y)
   Next
Next
xlsx.Save(1)
xlsx.Close(1)
Der obige Code erstellt ein neues XLSX-Dokument und fügt ihm 30 Spalten und 100 Zeilen hinzu. Das Dokument wird als test.xlsx gespeichert.

Navigation zeigen