Class Browser

浏览器

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

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

另请参阅

属性

属性类型说明
ButtonsButtonSet

方法

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

详细文档

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 - 用户输入的文本（对于已取消或关闭的对话框，则为“取消”）。

授权

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

  • 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 - 用户输入的文本（对于已取消或关闭的对话框，则为“取消”）。

授权

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

  • 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 - 用户输入的文本（对于已取消或关闭的对话框，则为“取消”）。

授权

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

  • 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');
 不建议使用此方法。请改用 UI 提醒对话框。

参数

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

返回

String - 用户点击的按钮的下划线文本（对于已关闭的对话框，则为“取消”）。

授权

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

  • 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);
 不建议使用此方法。请改用 UI 提醒对话框。

参数

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

返回

String - 用户点击的按钮的下划线文本（对于已关闭的对话框，则为“取消”）。

授权

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

  • 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);
 不建议使用此方法。请改用 UI 提醒对话框。

参数

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

返回

String - 用户点击的按钮的下划线文本（对于已关闭的对话框，则为“取消”）。

授权

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

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