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'.
var name = Browser.inputBox('Enter your name');
不推荐使用此方法。请改用界面提示。

参数

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

返回

String - 用户输入的文本（对于已取消或已关闭的对话框，则为“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'.
var name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);
不推荐使用此方法。请改用界面提示。

参数

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

返回

String - 用户输入的文本（对于已取消或已关闭的对话框，则为“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'.
var name = Browser.inputBox('ID Check', 'Enter your name', Browser.Buttons.OK_CANCEL);
不推荐使用此方法。请改用界面提示。

参数

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

返回

String - 用户输入的文本（对于已取消或已关闭的对话框，则为“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 - 用户点击的按钮的小写文本（如果是 已关闭的对话框）。

授权

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

  • 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 - 用户点击的按钮的小写文本（如果是 已关闭的对话框）。

授权

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

  • 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 - 用户点击的按钮的小写文本（如果是 已关闭的对话框）。

授权

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

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