requireCheckbox в DataValidation Builder

Question

Я всегда использую эти страницы, чтобы найти документацию по свойствам и методам, которые приложение google script предлагает автоматизировать в листах Google: https://developers.google.com/apps-script/reference/spreadsheet/data-validation-builder

Но, к сожалению, на странице о DataValidation Builder отсутствует информация о методе requireCheckbox.

Когда вы набираете его в Script File, он предлагает 3 варианта:

без аргументов: requireCheckbox ()

1 аргумент: requireCheckbox (Object checkedValue)

2 аргумента: requireCheckbox (Object checkedValue, Object uncheckedValue)

Может кто-нибудь объяснить, как работают аргументы для этого метода?Какие параметры объекта я могу использовать в этих аргументах и ​​для каких целей они могут служить?Я пытался найти информацию везде.Я знаю, что на этом форуме присутствуют эксперты и гуру из Google google, и они могут помочь в этом вопросе.

Answer 1

Ячейка

CHECKBOX по умолчанию имеет два значения:

• TRUE, если отмечено, и
• FALSE, если не отмечено.

В зависимости от количества аргументов, предоставляемых requireCheckbox, используются разные значения:

• Без аргумента:
  • Используются значения по умолчанию.
• Один аргумент:
  • Предоставленный аргумент, если отмечен
  • Пустой, когда не отмечен
• Двааргументы:
  • Предоставленные аргументы используются соответственно для проверенных и непроверенных состояний.

Пример кода:

function yesNoDV() {
  //Changes checked state to 'Yes'  and Unchecked state to 'No'
  SpreadsheetApp.getActive()
    .getRange('Sheet1!A1')
    .setDataValidation(
      SpreadsheetApp.newDataValidation()
        .requireCheckbox('Yes', 'No')
        .build()
    );
}