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.