Class Browser

Browser

Questa classe fornisce l'accesso alle finestre di dialogo specifiche di Fogli Google.

I metodi di questa classe sono disponibili solo per l'utilizzo nel contesto di un foglio di lavoro Google. Utilizza invece le finestre di dialogo di Google Workspace.

Vedi anche

• ButtonSet

Proprietà

Proprietà	Tipo	Descrizione
Buttons	ButtonSet

Metodi

Metodo	Tipo restituito	Breve descrizione
inputBox(prompt)	String|null	Visualizza una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.
inputBox(prompt, buttons)	String|null	Visualizza una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.
inputBox(title, prompt, buttons)	String|null	Visualizza una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.
msgBox(prompt)	String|null	Visualizza una finestra di dialogo con il messaggio specificato e un pulsante OK nel browser dell'utente.
msgBox(prompt, buttons)	String|null	Visualizza una finestra di dialogo con il messaggio specificato e i pulsanti specificati nel browser dell'utente.
msgBox(title, prompt, buttons)	String|null	Visualizza una finestra di dialogo con il titolo, il messaggio e i pulsanti specificati nel browser dell'utente.

Documentazione dettagliata

inputBox(prompt)

Visualizza una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.

Il metodo inputBox genera una casella di immissione lato client che mostra all'utente il prompt specificato. Tieni presente che questa funzione sospende lo script lato server. Riprende automaticamente dopo che l'utente ha chiuso la finestra di dialogo, ma le connessioni JDBC non persistono durante la sospensione.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');

Questo metodo non è consigliato. Utilizza invece un prompt dell'interfaccia utente.

Parametri

Nome	Tipo	Descrizione
prompt	String	Il testo da visualizzare nella finestra di dialogo.

Indietro

String|null : il testo inserito dall'utente (o "annulla" per una finestra di dialogo annullata o chiusa).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

inputBox(prompt, buttons)

Visualizza una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.

Il metodo inputBox genera una casella di immissione lato client che mostra all'utente il prompt specificato e offre una scelta di pulsanti da visualizzare. Tieni presente che questa funzione sospende lo script lato server. Riprende automaticamente dopo che l'utente ha chiuso la finestra di dialogo, ma le connessioni JDBC non persistono durante la sospensione.

// 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);

Questo metodo non è consigliato. Utilizza invece un prompt dell'interfaccia utente.

Parametri

Nome	Tipo	Descrizione
prompt	String	Il testo da visualizzare nella finestra di dialogo.
buttons	ButtonSet	Il tipo di set di pulsanti da utilizzare.

Indietro

String|null : il testo inserito dall'utente (o "annulla" per una finestra di dialogo annullata o chiusa).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

inputBox(title, prompt, buttons)

Visualizza una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.

Il metodo inputBox genera una casella di immissione lato client con il titolo specificato, che mostra all'utente il prompt specificato e offre una scelta di pulsanti da visualizzare. Tieni presente che questa funzione sospende lo script lato server. Riprende automaticamente dopo che l'utente ha chiuso la finestra di dialogo, ma le connessioni JDBC non persistono durante la sospensione.

// 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,
);

Questo metodo non è consigliato. Utilizza invece un prompt dell'interfaccia utente.

Parametri

Nome	Tipo	Descrizione
title	String	Il titolo della finestra di dialogo.
prompt	String	Il testo da visualizzare nella finestra di dialogo.
buttons	ButtonSet	Il tipo di set di pulsanti da utilizzare.

Indietro

String|null : il testo inserito dall'utente (o "annulla" per una finestra di dialogo annullata o chiusa).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

msgBox(prompt)

Visualizza una finestra di dialogo con il messaggio specificato e un pulsante OK nel browser dell'utente.

Il metodo msgBox genera una finestra di messaggio lato client che mostra all'utente il messaggio specificato. Tieni presente che questo metodo sospende lo script lato server. Riprende automaticamente dopo che l'utente ha chiuso la finestra di dialogo, ma le connessioni JDBC non persistono durante la sospensione.

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

Questo metodo non è consigliato. Utilizza invece una finestra di dialogo di avviso dell'interfaccia utente.

Parametri

Nome	Tipo	Descrizione
prompt	String	Il testo da visualizzare nella finestra di dialogo.

Indietro

String|null : il testo in minuscolo del pulsante su cui l'utente ha fatto clic (o "annulla" per una finestra di dialogo chiusa).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

msgBox(prompt, buttons)

Visualizza una finestra di dialogo con il messaggio specificato e i pulsanti specificati nel browser dell'utente.

Il metodo msgBox genera una finestra di messaggio lato client che mostra all'utente il messaggio specificato e offre una scelta di pulsanti da visualizzare. Tieni presente che questo metodo sospende lo script lato server. Riprende automaticamente dopo che l'utente ha chiuso la finestra di dialogo, ma le connessioni JDBC non persistono durante la sospensione.

// The code below displays "hello world" in a dialog box with OK and Cancel
// buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);

Questo metodo non è consigliato. Utilizza invece una finestra di dialogo di avviso dell'interfaccia utente.

Parametri

Nome	Tipo	Descrizione
prompt	String	Il testo da visualizzare nella finestra di dialogo.
buttons	ButtonSet	Il tipo di set di pulsanti da utilizzare.

Indietro

String|null : il testo in minuscolo del pulsante su cui l'utente ha fatto clic (o "annulla" per una finestra di dialogo chiusa).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

---

msgBox(title, prompt, buttons)

Visualizza una finestra di dialogo con il titolo, il messaggio e i pulsanti specificati nel browser dell'utente.

Il metodo msgBox genera una finestra di messaggio lato client con il titolo specificato, che mostra all'utente il messaggio specificato e offre una scelta di pulsanti da visualizzare. Tieni presente che questo metodo sospende lo script lato server. Riprende automaticamente dopo che l'utente ha chiuso la finestra di dialogo, ma le connessioni JDBC non persistono durante la sospensione.

// 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);

Questo metodo non è consigliato. Utilizza invece una finestra di dialogo di avviso dell'interfaccia utente.

Parametri

Nome	Tipo	Descrizione
title	String	Il titolo della finestra di dialogo.
prompt	String	Il testo da visualizzare nella finestra di dialogo.
buttons	ButtonSet	Il tipo di set di pulsanti da utilizzare.

Indietro

String|null : il testo in minuscolo del pulsante su cui l'utente ha fatto clic (o "annulla" per una finestra di dialogo chiusa).

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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