Перейти к основному содержимому

isLocked()

Описание

Проверяет, заблокирована ли ячейка(и)

Использование

isLocked(cell: string): boolean;

Параметры

  • cell - (обязательный) идентификатор(ы) ячейки(ек) или диапазон ячеек

Возвращаемое значение

Метод возвращает true, если ячейка заблокирована, и false, если она разблокирована

Пример

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

// проверяет, заблокирована ли ячейка
const cellLocked = spreadsheet.isLocked("A1");

// проверяет, заблокированы ли несколько ячеек
const rangeLocked = spreadsheet.isLocked("A1:C1");

// проверяет, заблокированы ли разрозненные ячейки
const cellsLocked = spreadsheet.isLocked("A1,B5,B7,D4:D6");
К сведению

Если одновременно проверяется несколько ячеек, метод возвращает true, если среди указанных ячеек есть хотя бы одна заблокированная.

К сведению

Начиная с версии v4.1, ссылку на ячейку или диапазон ячеек можно задавать в следующем формате:

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

где sheet1 — название вкладки.

Если название вкладки не указано, метод проверяет ячейку(и) активной вкладки.