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