protectSheet

await crafttechApi.protectSheet(filePath, sheetName, password);

Описание

Устанавливает защиту на лист от редактирования.

Параметры

• filePath (string) — путь до файла;
• sheetName (string) — название листа;
• password (string) — пароль для защиты.

Возвращает

• true | false (boolean) — логическая истина true в случае успешной защиты листа. Если лист уже защищён, метод вернёт false, а пароль останется прежним.

Пример

const result = await crafttechApi.protectSheet(
  "fileToProtect.xlsx",
  "Лист1",
  "qwerty"
);
console.log("protectSheet(): ", result);

Код выше защитит лист «Лист1» файла fileToProtect.xlsx таким образом, что пользователь не сможет изменять содержимое ячеек: при попытке сделать это выводится окно, что лист защищён и для его снятия нужен пароль.

Если указать пароль, то при попытке снять защиту через интерфейс Р7-Офис (Защита > опция “Защитить лист”) программа потребует пароль. Если не указывать пароль, то для снятия защиты нужно просто нажать на опцию).