setCellSize

await crafttechApi.setCellSize(fileHandler, sheetName, cellAddress, sizes);

Описание

Позволяет изменить высоту и ширину ячейки (т.е. ее строки и колонки). Размеры принимаются в пунктах для высоты и в символах для ширины. (Такие величины используются в MS Excel и Р7-Офис)

Совет: если вам необходимо изменить размеры у диапазона ячеек (например, возьмем диапазон A3:D20), то вы можете изменить размеры ячеек только с боковой стороны (A3:A20 и A3:D3), остальные ячейки будут иметь идентичный размер.

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

Параметры

• fileHandler (fileID) — ссылка на файл; ссылку предоставляет метод openFile;
• sheetName (string) — имя листа, на котором необходимо изменить размер ячейки;
• cellAddress (string) — координаты или адрес ячейки, размеры которой необходимо изменить;
• sizes (object) — объект, который имеет два поля:
  • height (number) — высота ячейки в пунктах;
  • width (number) — ширина ячейки в символах.

Дополнение: объект sizes может включать в себя как ширину и высоту одновременно, так и один из параметров. Пустой объект будет просто пропущен, метод вернет true.

Возвращает

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

Пример

let sizes = {
  height: 35.75,
  width: 12.45,
};
const result = await crafttechApi.setCellSize(
  fileHandler,
  "Лист1",
  "G5",
  sizes
);
console.log(result);