Questa pagina è stata tradotta dall'API Cloud Translation.

Class Browser

Questo corso consente di accedere a finestre di dialogo specifiche di Fogli Google.

I metodi di questa classe sono disponibili solo nel contesto di un foglio di lavoro Google. Utilizza 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`	Mostra una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.
`inputBox(prompt, buttons)`	`String`	Mostra una finestra di dialogo con una casella di immissione di testo nel browser dell'utente.
`inputBox(title, prompt, buttons)`	`String`	Mostra 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`	Mostra una finestra di dialogo con il messaggio specificato 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)`

Mostra 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 specificato all'utente. Tieni presente che questa funzione causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente cancella 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'.
var 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.

Ritorni

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

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

Il metodo inputBox solleva una casella di immissione lato client che mostra la richiesta specificata all'utente e offre una serie di pulsanti da visualizzare. Tieni presente che questa funzione causa la sospensione dello script lato server. Riprende automaticamente dopo la cancellazione della finestra di dialogo da parte dell'utente, 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'.
var 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 da utilizzare.

Ritorni

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

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

Il metodo inputBox solleva una casella di immissione lato client con il titolo specificato, visualizza il prompt specificato per l'utente e offre una serie di pulsanti da visualizzare. Tieni presente che questa funzione causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente cancella 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'.
var 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 da utilizzare.

Ritorni

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 causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente cancella 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 nell'interfaccia utente.

Parametri

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

Ritorni

String: il testo in minuscolo del pulsante su cui l'utente ha fatto clic (oppure "Annulla" per una finestra di dialogo 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, buttons)`

Mostra 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 il messaggio specificato all'utente e offre una serie di pulsanti da visualizzare. Tieni presente che questo metodo causa la sospensione dello script lato server. Riprende automaticamente dopo la cancellazione della finestra di dialogo da parte dell'utente, 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 nell'interfaccia utente.

Parametri

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

Ritorni

String: il testo in minuscolo del pulsante su cui l'utente ha fatto clic (oppure "Annulla" per una finestra di dialogo 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(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, visualizza il messaggio specificato per l'utente e offre una serie di pulsanti da visualizzare. Tieni presente che questo metodo causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente cancella 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 nell'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 da utilizzare.

Ritorni

String: il testo in minuscolo del pulsante su cui l'utente ha fatto clic (oppure "Annulla" per una finestra di dialogo 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