Class Browser

浏览器

此类提供对 Google 表格专用对话框的访问权限。

此类中的方法只能在 Google 电子表格的上下文中调用。 请改用 Google Workspace 对话框。

另请参阅

属性

属性类型说明
ButtonsButtonSet

方法

方法返回值类型简介
inputBox(prompt)String|null在用户的浏览器中弹出一个包含文本输入框的对话框。
inputBox(prompt, buttons)String|null在用户的浏览器中弹出一个包含文本输入框的对话框。
inputBox(title, prompt, buttons)String|null在用户的浏览器中弹出一个包含文本输入框的对话框。
msgBox(prompt)String|null在用户的浏览器中弹出一个包含给定消息和“确定”按钮的对话框。
msgBox(prompt, buttons)String|null在用户的浏览器中弹出一个包含给定消息和指定按钮的对话框。
msgBox(title, prompt, buttons)String|null在用户的浏览器中弹出一个包含给定标题、消息和指定按钮的对话框。

详细文档

inputBox(prompt)

在用户的浏览器中弹出一个包含文本输入框的对话框。

inputBox 方法会显示一个客户端输入框，向用户显示给定的提示。请注意，此函数会导致服务器端脚本暂停。它会在用户关闭对话框后自动恢复，但 JDBC 连接不会在暂停期间保留。 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');
 不建议使用此方法。请改用界面提示。

参数

名称类型说明
promptString要在对话框中显示的文本。

返回

String|null - 用户输入的文本（如果对话框被取消或关闭，则为“cancel”）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(prompt, buttons)

在用户的浏览器中弹出一个包含文本输入框的对话框。

inputBox 方法会显示一个客户端输入框，向用户显示给定的提示，并提供要显示的按钮供用户选择。请注意，此函数会导致服务器端脚本暂停。它会在用户关闭对话框后自动恢复，但 JDBC 连接不会在暂停期间保留。 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
 不建议使用此方法。请改用界面提示。

参数

名称类型说明
promptString要在对话框中显示的文本。
buttonsButtonSet要使用的按钮集类型。

返回

String|null - 用户输入的文本（如果对话框被取消或关闭，则为“cancel”）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

inputBox(title, prompt, buttons)

在用户的浏览器中弹出一个包含文本输入框的对话框。

inputBox 方法会显示一个客户端输入框，其中包含给定的标题，向用户显示给定的提示，并提供要显示的按钮供用户选择。请注意，此函数会导致服务器端脚本暂停。它会在用户关闭对话框后自动恢复，但 JDBC 连接不会在暂停期间保留。 

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);
 不建议使用此方法。请改用界面提示。

参数

名称类型说明
titleString对话框的标题。
promptString要在对话框中显示的文本。
buttonsButtonSet要使用的按钮集类型。

返回

String|null - 用户输入的文本（如果对话框被取消或关闭，则为“cancel”）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt)

在用户的浏览器中弹出一个包含给定消息和“确定”按钮的对话框。

msgBox 方法会显示一个客户端消息框，向用户显示给定的消息。请注意，此方法会导致服务器端脚本暂停。它会在用户关闭对话框后自动恢复，但 JDBC 连接不会在暂停期间保留。 

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
 不建议使用此方法。请改用界面提醒对话框。

参数

名称类型说明
promptString要在对话框中显示的文本。

返回

String|null - 用户点击的按钮的小写文本（如果对话框被关闭，则为“cancel”）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(prompt, buttons)

在用户的浏览器中弹出一个包含给定消息和指定按钮的对话框。

msgBox 方法会显示一个客户端消息框，向用户显示给定的消息，并提供要显示的按钮供用户选择。请注意，此方法会导致服务器端脚本暂停。它会在用户关闭对话框后自动恢复，但 JDBC 连接不会在暂停期间保留。 

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
 不建议使用此方法。请改用界面提醒对话框。

参数

名称类型说明
promptString要在对话框中显示的文本。
buttonsButtonSet要使用的按钮集类型。

返回

String|null - 用户点击的按钮的小写文本（如果对话框被关闭，则为“cancel”）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

msgBox(title, prompt, buttons)

在用户的浏览器中弹出一个包含给定标题、消息和指定按钮的对话框。

msgBox 方法会显示一个客户端消息框，其中包含给定的标题，向用户显示给定的消息，并提供要显示的按钮供用户选择。请注意，此方法会导致服务器端脚本暂停。它会在用户关闭对话框后自动恢复，但 JDBC 连接不会在暂停期间保留。 

// The code below displays "hello world" in a dialog box with a custom title and
// Yes and No buttons
Browser.msgBox('Greetings', 'hello world', Browser.Buttons.YES_NO);
 不建议使用此方法。请改用界面提醒对话框。

参数

名称类型说明
titleString对话框的标题。
promptString要在对话框中显示的文本。
buttonsButtonSet要使用的按钮集类型。

返回

String|null - 用户点击的按钮的小写文本（如果对话框被关闭，则为“cancel”）。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets