DataValidationBuilder 类上的 requireCheckbox 方法签名含义

Question

不幸的是，有关构建器的 Apps 脚本文档页面DataValidation缺少有关该requireCheckbox方法的信息。

但是，当您通过脚本文件输入它时，自动完成提供了 3 个重载：

没有参数：

requireCheckbox()

1 个参数：

requireCheckbox(Object checkedValue)

2 个参数：

requireCheckbox(Object checkedValue, Object uncheckedValue)

我可以在这些参数中使用对象的哪些参数以及它们可以用于什么目的？

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