Question

我一直在使用这些页面来查找有关Google脚本应用提供的属性和方法的文档，这些属性和方法可以使Google表格中的内容自动化： https://developers.google.com/apps-script/reference/spreadsheet/data-validation-builder

但是不幸的是，有关DataValidation Builder的页面缺少有关requireCheckbox方法的信息。

当您在脚本文件中键入它时，尽管它提供3种变体：

没有参数：requireCheckbox（）

1 arg：requireCheckbox（ObjectcheckedValue）

2个参数：requireCheckbox（对象checkedValue，对象uncheckedValue）

有人可以解释一下此方法的参数如何工作吗？我可以在这些参数中使用对象的哪些参数，以及它们可以用于什么目的？我试图在各处找到信息。我知道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()
    );
}

Answer 2

Object 是 Google 文档在更具体的类型不适用时使用的默认类型。您可以安全地将其解释为 any 的模拟（实际上，Google Apps Script 的 @types TypeScript 包将这些参数用 any 注释）。

此外，截至 2021 年，the documentation 包含有关所有方法重载的信息。引用它，重载函数如下。

没有争论

<块引用>

设置数据验证规则要求输入是布尔值；此值呈现为复选框。

一个论点

<块引用>

将数据验证规则设置为要求输入为指定值或空白。当输入与指定值匹配时，单元格将呈现为选中的复选框。当输入为空白时，单元格呈现为未选中的复选框。

两个参数

<块引用>

将数据验证规则设置为要求输入是指定值之一。当输入为 checkedValue 时，单元格呈现为选中的复选框。当输入为 uncheckedValue 时，单元格呈现为未选中的复选框。

每个重载的含义与 TheMaster 的 answer 中概述的含义相同。

DataValidation Builder中的requireCheckbox

2 个答案:

示例代码：