Questa pagina è stata tradotta dall'API Cloud Translation.

Class 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 dialoghe di Google Workspace.

Vedi anche

ButtonSet

Proprietà

Proprietà	Tipo	Descrizione
`Buttons`	`ButtonSet`

Metodi

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

Documentazione dettagliata

`inputBox(prompt)`

Viene visualizzata 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 la richiesta specificata. Tieni presente che questa funzione causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente chiude la finestra di dialogo, ma le connessioni JDBC non vengono mantenute 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.

Invio

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

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)`

Viene visualizzata 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 il prompt all'utente e offre una scelta di pulsanti da visualizzare. Tieni presente che questa funzione fa sì che lo script lato server venga sospeso. Riprende automaticamente dopo che l'utente ha cancellato la finestra di dialogo, ma le connessioni JDBC non vengono mantenute 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 pulsante impostato per l'utilizzo.

Invio

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

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)`

Viene visualizzata 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 il prompt fornito all'utente e offre una scelta di pulsanti da visualizzare. Tieni presente che questa funzione comporta la sospensione dello script lato server. Riprende automaticamente dopo che l'utente ha cancellato la finestra di dialogo, ma le connessioni JDBC non vengono mantenute 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 pulsante impostato per l'utilizzo.

Invio

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

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)`

Viene visualizzata 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 il messaggio specificato all'utente. Tieni presente che questo metodo comporta la sospensione dello script lato server. Riprende automaticamente dopo che l'utente chiude la finestra di dialogo, ma le connessioni JDBC non vengono mantenute 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 UI.

Parametri

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

Invio

String: il testo in minuscolo del pulsante su cui fa clic l'utente (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)`

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

Il metodo msgBox genera una finestra di messaggio lato client che mostra il messaggio specificato all'utente e offre una scelta di pulsanti da visualizzare. Tieni presente che questo metodo comporta la sospensione dello script lato server. Riprende automaticamente dopo che l'utente ha cancellato la finestra di dialogo, ma le connessioni JDBC non vengono mantenute 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 UI.

Parametri

Nome	Tipo	Descrizione
`prompt`	`String`	Il testo da visualizzare nella finestra di dialogo.
`buttons`	`ButtonSet`	Il tipo di pulsante impostato per l'utilizzo.

Invio

String: il testo in minuscolo del pulsante su cui fa clic l'utente (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)`

Viene visualizzata 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 il messaggio all'utente e offre una scelta di pulsanti da visualizzare. Tieni presente che questo metodo comporta la sospensione dello script lato server. Riprende automaticamente dopo che l'utente ha cancellato la finestra di dialogo, ma le connessioni JDBC non vengono mantenute 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 UI.

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 pulsante impostato per l'utilizzo.

Invio

String: il testo in minuscolo del pulsante su cui fa clic l'utente (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