Zum Hauptinhalt springen

setValue()

Beschreibung

Setzt einen Wert für eine Zelle

Info

Die Methode setzt denselben (wiederholten) Wert bzw. dieselben Werte für die angegebenen Zellen. Wenn Sie verschiedene Werte in Spreadsheet-Zellen einfügen möchten, verwenden Sie die Methode parse().

Verwendung

setValue(cell: string, value: string | number | array): void;

Parameter

  • cell - (erforderlich) die ID(s) einer Zelle oder eines Zellbereichs
  • value - (erforderlich) der/die Wert(e), der/die für die Zellen gesetzt werden soll(en)

Beispiel

const spreadsheet = new dhx.Spreadsheet("spreadsheet", {});
spreadsheet.parse(data);

// Wert für eine einzelne Zelle setzen
spreadsheet.setValue("A1",5);

// denselben Wert für einen Zellbereich setzen
spreadsheet.setValue("A1:D1",5);

// denselben Wert für verschiedene Zellen setzen
spreadsheet.setValue("B6,A1:D1",5);

// Werte aus einem Array abwechselnd auf Zellen in einem Bereich anwenden
spreadsheet.setValue("A1:D1",[1,2,3]);

Verwandtes Beispiel: Spreadsheet. Initialisierung mit mehreren Tabellenblättern

Info

Ab v4.1 kann der Verweis auf eine Zelle oder einen Zellbereich im folgenden Format angegeben werden:

spreadsheet.setValue("sheet1!A1",5);

wobei sheet1 der Name des Reiters ist.

Wenn der Name des Reiters nicht angegeben ist, setzt die Methode den/die Wert(e) für die Zelle(n) des aktiven Reiters.