convertCellToCheckbox

await crafttechApi.convertCellToCheckbox(range, options, flag);

Описание

Формирует чекбоксы (флажки) на место указанных ячеек в активном файле, из которого запущен текущий макрос.

Данный метод был разработал ввиду ограничений Р7-Офис Таблицы, не предусматривающих создание и взаимодействие с пользовательскими формами и элементами управления.

Не путать с convertCellToRadiobox, который подразумевает единичный выбор опций. В convertCellToCheckbox можно выбрать несколько ячеек из диапазона.

Макрос, использующий данный метод, должен работать в формате автозапуска (А).

Параметры

• range (string[] | string) — диапазон ячеек, на основе которых формируются чекбоксы; принимаются диапазоны в виде:
  • одного диапазона в строковом формате ("A1:F1");
  • массива строк с адресами ячеек (["A1", "B1", "C1", "D1", "E1", "F1"]);
  • микс адресов ячеек и диапазонов ячеек в виде массива (["A1", "B1:B4", "C1", "D1", "E1", "F1:F2", "A5:C5"]);
• options (string[]) — необязательный параметр; массив с двумя строками, означающие бинарные опции с состояниями true или false, соответственно (то есть, если чекбокс активен, то ячейка принимает значение первого элемента параметра, если неактивен, то второго):
  • если параметр не передаётся или равен пустой строке, на месте ячеек формируются классические чекбоксы в привычном виде: квадрат, внутри которого отмечена или не отмечена галочка в зависимости от состояния;
• flag (string) — необязательный параметр; флаг, указывающий, должны ли активизироваться все чекбоксы в диапазоне при нажатии на одну из них (то есть «выбрать всё»):
  • all — выбрать всё.

Возвращает

Метод ничего не возвращает.

Пример

await crafttechApi.convertCellToCheckbox("A1:A4");

await crafttechApi.convertCellToCheckbox("A1:A4", ["да", "нет"]);

await crafttechApi.convertCellToCheckbox([
  "A1",
  "B1:B4",
  "C1",
  "D1",
  "E1",
  "F1:F2",
  "A5:C5",
]);