isLocked()

Beschreibung

Prüft, ob eine Zelle/Zellen gesperrt ist/sind

Verwendung

isLocked(cell: string): boolean;

Parameter

• cell - (erforderlich) die ID(s) einer Zelle/von Zellen oder ein Zellbereich

Rückgabewert

Die Methode gibt true zurück, wenn die Zelle gesperrt ist, und false, wenn sie entsperrt ist

Beispiel

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

// Prüft, ob eine Zelle gesperrt ist
const cellLocked = spreadsheet.isLocked("A1");

// Prüft, ob mehrere Zellen gesperrt sind
const rangeLocked = spreadsheet.isLocked("A1:C1");

// Prüft, ob einzeln ausgewählte Zellen gesperrt sind
const cellsLocked = spreadsheet.isLocked("A1,B5,B7,D4:D6");

Info

Wenn mehrere Zellen gleichzeitig geprüft werden, gibt die Methode true zurück, wenn mindestens eine der angegebenen Zellen gesperrt ist.

Info

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

const cellsLocked = spreadsheet.isLocked("sheet1!A2"); 

Dabei ist sheet1 der Name des Tabs.

Wenn der Name des Tabs nicht angegeben ist, prüft die Methode die Zelle(n) des aktiven Tabs.