Class Browser

Browser

Questa classe fornisce l'accesso a 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

Proprietà

ProprietàTipoDescrizione
ButtonsButtonSet

Metodi

MetodoTipo restituitoBreve descrizione
inputBox(prompt)String|nullViene visualizzata una finestra di dialogo con una casella di input di testo nel browser dell'utente.
inputBox(prompt, buttons)String|nullViene visualizzata una finestra di dialogo con una casella di input di testo nel browser dell'utente.
inputBox(title, prompt, buttons)String|nullViene visualizzata una finestra di dialogo con una casella di input di testo nel browser dell'utente.
msgBox(prompt)String|nullVisualizza una finestra di dialogo con il messaggio specificato e un pulsante OK nel browser dell'utente.
msgBox(prompt, buttons)String|nullVisualizza una finestra di dialogo con il messaggio specificato e i pulsanti specificati nel browser dell'utente.
msgBox(title, prompt, buttons)String|nullVisualizza 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 input di testo nel browser dell'utente.

Il metodo inputBox genera una casella di input lato client che mostra all'utente il prompt specificato. Tieni presente che questa funzione causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente ha chiuso 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

NomeTipoDescrizione
promptStringIl 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)

Viene visualizzata una finestra di dialogo con una casella di input di testo nel browser dell'utente.

Il metodo inputBox genera una casella di input lato client che mostra all'utente il prompt specificato e offre una scelta di pulsanti da visualizzare. Tieni presente che questa funzione causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente ha chiuso 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

NomeTipoDescrizione
promptStringIl testo da visualizzare nella finestra di dialogo.
buttonsButtonSetIl 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)

Viene visualizzata una finestra di dialogo con una casella di input di testo nel browser dell'utente.

Il metodo inputBox genera una casella di input lato client con il titolo specificato, che mostra il prompt specificato all'utente e offre una scelta 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'.
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

NomeTipoDescrizione
titleStringIl titolo della finestra di dialogo.
promptStringIl testo da visualizzare nella finestra di dialogo.
buttonsButtonSetIl 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 casella 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 ha chiuso 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 avviso UI.

Parametri

NomeTipoDescrizione
promptStringIl testo da visualizzare nella finestra di dialogo.

Indietro

String|null: 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)

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

Il metodo msgBox genera una casella di messaggio lato client che mostra il messaggio dato all'utente e offre una scelta di pulsanti da visualizzare. Tieni presente che questo metodo causa la sospensione dello script lato server. Riprende automaticamente dopo che l'utente ha chiuso 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 avviso UI.

Parametri

NomeTipoDescrizione
promptStringIl testo da visualizzare nella finestra di dialogo.
buttonsButtonSetIl tipo di set di pulsanti da utilizzare.

Indietro

String|null: 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)

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

Il metodo msgBox genera una casella 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 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 avviso UI.

Parametri

NomeTipoDescrizione
titleStringIl titolo della finestra di dialogo.
promptStringIl testo da visualizzare nella finestra di dialogo.
buttonsButtonSetIl tipo di set di pulsanti da utilizzare.

Indietro

String|null: 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