convertCellsToBoxes

await crafttechApi.convertCellsToBoxes({checkboxes:[{range: string, flag?: boolean}], radioboxes:[{range: string, checked?: string}]});

Описание

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

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

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

Можно использовать вместо предыдущих версий методов конвертации, просто указывая какой-то один массив.

Для получения символов (да, нет) использовать методы: -getDefaultCheckboxValues -getDefaultRadioboxValues

await crafttechApi.convertCellsToBoxes({
  checkboxes: [{ range: "Лист1!A1:A5", flag: false }],
});

Параметры

• checkboxes (Array) — массив объектов, на основе которых формируются чекбоксы; у каждого объекта есть свойства:
  • range (string) одного диапазона, с указанием листа, в строковом формате ("Лист1!A1:F1");
  • flag? (boolean) необязательный параметр; флаг, указывающий, должны ли активизироваться все чекбоксы в диапазоне при нажатии на одну из них (то есть «выбрать всё»); если не указано, то по умолчанию ставится false
• radioboxes (Array) — массив объектов, на основе которых формируются радиобоксы; у каждого объекта есть свойства:
  • range (string) одного диапазона, с указанием листа, в строковом формате ("Лист1!A1:F1");
  • checked? (string) необязательный параметр; адрес ячейки, указывающий, где автоматически должно быть отмечено (“C1”); если не указано, возьмётся первая ячейка в диапазоне (“A1”).

Возвращает

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

Пример

await crafttechApi.convertCellsToBoxes({
  checkboxes: [{ range: "Лист1!A1:A5", flag: false }],
  radioboxes: [{ range: "Лист1!B1:B3", checked: "B2" }],
});