copyCellRange

await crafttechApi.copyCellRange(
  fileHandlerSource,
  sheetNameSource,
  rangeSource,
  fileHandlerTarget,
  sheetNameTarget,
  rangeTarget,
  flag='value, style, formula
')

Описание

Копирует диапазон листа книги.

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

Параметры

• fileHandleSource (number) — ссылка на файл, из которого мы копируем лист; ссылку предоставляет метод openFile;
• sheetNameSource (string) — название листа, из которого копируется диапазон;
• rangeSource (string) — копируемый диапазон; адреса ячеек разделяются двоеточием (например: A1:C2, либо 1,1:2,3; во втором случае сначала передаётся строка, а потом столбец);
• fileHandlerTarget (number) — ссылка на файл, в который копируется диапазон; если мы хотим скопировать диапазон в этот же файл, fileHandlerTarget должен совпадать с fileHandlerSource;
• sheetNameTarget (string) — название листа, в который копируется диапазон;
• rangeTarget (string) — диапазон, в который копируются ячейки; адреса ячеек разделяются двоеточием (например: A1:C2, либо 1,1:2,3; во втором случае сначала передаётся строка, а потом столбец);
• flag (string|{ insert: string, clear: string}) — необязательный параметр, указывающий, какие данные ячейки нужно скопировать:
  • value — только значения;
  • style — только стили.
  • formula — только формулы.
  • флаги можно комбинировать, перечисляя их через запятую, например: value, formula.
  • также можно указать какие данные мы хотим удалить в редактируемом диапазоне:

{
  "insert": "value, style, formula",
  "clear": "value, formula, merge, style"
}

Возвращает

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

Пример

const check = await crafttechApi.copyCellRange(
  fhSource,
  "Лист1",
  "A1:A3",
  fhTarget,
  "Лист1",
  "C1:C3", //   '1,3:3,3',
  "value, style"
);

После выполнения данного кода из исходного файла скопируются ячейки A1:A3 и вставятся в другой файл в диапазон C1:C3 с сохранением стилей.

Пример переноса из 1й ячейки

const check = await crafttechApi.copyCellRange(
  fhSource,
  "Лист1",
  "A1",
  fhTarget,
  "Лист1",
  "C1:C3", //   '1,3:3,3',
  "value, style, formula"
);

После выполнения данного кода из исходного файла скопируются ячейки A1 и вставятся в другой файл в диапазон C1:C3 с сохранением стилей.