insertRowFile

await crafttechApi.insertRowFile(
  fileHandler,
  sheetName,
  rowNumber,
  (rowCount = 1)
);

Описание

Вставляет пустую строку на указанную позицию со смещением вниз.

Требует сохранения при помощи saveFile (для внешнего файла), либо applyActiveFileChanges (для активного файла).

Параметры

• fileHandler (number) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — название листа;
• rowNumber (number) — номер строки;
• rowCount (number) — необязательный параметр (по умолчанию 1); количество вставленных пустых строк.

Возвращает

• true | false (boolean) — логическая истина true в случае успешного добавления пустой строки.

Пример

const result = await crafttechApi.insertRowFile(fileHandler, "Лист1", 3, 4);
console.log("Строки вставлены: ", result);

Код выше добавит четыре пустых ряда, начиная со строки 3, в листе «Лист1». Соответственно, все находящиеся ниже строки будут смещены на четыре позиции вниз, со строки 3 на строку 7.