本頁面由 Cloud Translation API 翻譯而成。

Class Browser

這個類別可讓您存取 Google 試算表專用的對話方塊。

這個類別中的各項方法僅適用於 Google 試算表的內容。請改用 Google Workspace 對話方塊。

另請參閱

ButtonSet

屬性

屬性	類型	說明
`Buttons`	`ButtonSet`

方法

方法	傳回類型	簡短說明
`inputBox(prompt)`	`String`	在使用者的瀏覽器中彈出對話方塊，其中含有文字輸入方塊。
`inputBox(prompt, buttons)`	`String`	在使用者的瀏覽器中彈出對話方塊，其中包含文字輸入方塊。
`inputBox(title, prompt, buttons)`	`String`	在使用者的瀏覽器中彈出對話方塊，其中含有文字輸入方塊。
`msgBox(prompt)`	`String`	在使用者的瀏覽器中彈出對話方塊，其中包含指定訊息和「OK」按鈕。
`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');

我們不建議使用這個方法。請改用 UI 提示。

參數

名稱	類型	說明
`prompt`	`String`	對話方塊中顯示的文字。

回攻員

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'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);

我們不建議使用這個方法。請改用 UI 提示。

參數

名稱	類型	說明
`prompt`	`String`	對話方塊中顯示的文字。
`buttons`	`ButtonSet`	要使用的按鈕集合類型。

回攻員

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'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);

我們不建議使用這個方法。請改用 UI 提示。

參數

名稱	類型	說明
`title`	`String`	對話方塊的標題。
`prompt`	`String`	對話方塊中顯示的文字。
`buttons`	`ButtonSet`	要使用的按鈕集合類型。

回攻員

String：使用者輸入的文字 (如果對話方塊已取消或關閉，則為「cancel」)。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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

`msgBox(prompt)`

在使用者的瀏覽器中彈出對話方塊，其中包含指定的訊息和「OK」按鈕。

msgBox 方法會產生用戶端訊息方塊，向使用者顯示指定的訊息。請注意，這個方法會導致伺服器端指令碼暫停。使用者清除對話方塊後，系統會自動恢復，但 JDBC 連線不會在暫停期間保留。

// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');

我們不建議使用這個方法。請改用 UI 警示對話方塊。

參數

名稱	類型	說明
`prompt`	`String`	對話方塊中顯示的文字。

回攻員

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 警示對話方塊。

參數

名稱	類型	說明
`prompt`	`String`	對話方塊中顯示的文字。
`buttons`	`ButtonSet`	要使用的按鈕集合類型。

回攻員

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 警示對話方塊。

參數

名稱	類型	說明
`title`	`String`	對話方塊的標題。
`prompt`	`String`	對話方塊中顯示的文字。
`buttons`	`ButtonSet`	要使用的按鈕集合類型。

回攻員

String：使用者按下的按鈕小寫文字 (或關閉對話方塊的「取消」)。

授權

使用這個方法的腳本需要具備下列一或多個範圍的授權：

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