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

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);