Cette classe permet d'accéder à des boîtes de dialogue spécifiques à Google Sheets.
Les méthodes de cette classe ne peuvent être utilisées que dans le contexte d'une feuille de calcul Google Sheets. Veuillez utiliser les boîtes de dialogue Google Workspace à la place.
Voir aussi
Propriétés
| Propriété | Type | Description |
|---|---|---|
Buttons | ButtonSet |
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
inputBox(prompt) | String | Ouvre une boîte de dialogue contenant une zone de saisie de texte dans le navigateur de l'utilisateur. |
inputBox(prompt, buttons) | String | Ouvre une boîte de dialogue contenant une zone de saisie de texte dans le navigateur de l'utilisateur. |
inputBox(title, prompt, buttons) | String | Ouvre une boîte de dialogue contenant une zone de saisie de texte dans le navigateur de l'utilisateur. |
msgBox(prompt) | String | Ouvre une boîte de dialogue contenant le message affiché et un bouton "OK" dans le navigateur de l'utilisateur. |
msgBox(prompt, buttons) | String | Ouvre une boîte de dialogue contenant le message affiché et les boutons spécifiés dans le navigateur de l'utilisateur. |
msgBox(title, prompt, buttons) | String | Ouvre une boîte de dialogue contenant le titre, le message et les boutons spécifiés dans le navigateur de l'utilisateur. |
Documentation détaillée
inputBox(prompt)
Ouvre une boîte de dialogue contenant une zone de saisie de texte dans le navigateur de l'utilisateur.
La méthode inputBox génère une zone de saisie côté client qui affiche la requête donnée à la utilisateur. Notez que cette fonction entraîne la suspension du script côté serveur. Reprise automatiquement après que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas la suspension.
// The code below sets the value of name to the name input by the user, or 'cancel'.
var name = Browser.inputBox('Enter your name');
Cette méthode n'est pas recommandée. Utilisez plutôt une invite de l'interface utilisateur.Paramètres
| Nom | Type | Description |
|---|---|---|
prompt | String | Texte à afficher dans la boîte de dialogue. |
Renvois
String : texte saisi par l'utilisateur (ou "annuler" pour une boîte de dialogue annulée ou fermée).
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
inputBox(prompt, buttons)
Ouvre une boîte de dialogue contenant une zone de saisie de texte dans le navigateur de l'utilisateur.
La méthode inputBox génère une zone de saisie côté client qui affiche la requête donnée à la utilisateur et propose un choix de boutons à afficher. Notez que cette fonction entraîne script côté serveur soit suspendu. Elle reprend automatiquement après que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne sont pas conservées.
// 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);
Cette méthode n'est pas recommandée. Utilisez plutôt une invite de l'interface utilisateur.Paramètres
| Nom | Type | Description |
|---|---|---|
prompt | String | Texte à afficher dans la boîte de dialogue. |
buttons | ButtonSet | Type de bouton défini à utiliser. |
Renvois
String : texte saisi par l'utilisateur (ou "annuler" pour une boîte de dialogue annulée ou fermée).
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
inputBox(title, prompt, buttons)
Ouvre une boîte de dialogue contenant une zone de saisie de texte dans le navigateur de l'utilisateur.
La méthode inputBox génère une zone de saisie côté client avec le titre donné, qui affiche le invite présentée à l'utilisateur, et propose un choix de boutons à afficher. Notez que cette entraîne la suspension du script côté serveur. Il est réactivé automatiquement une fois que l'utilisateur efface la boîte de dialogue, mais les connexions JDBC ne sont pas conservées pendant la suspension.
// 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);
Cette méthode n'est pas recommandée. Utilisez plutôt une invite de l'interface utilisateur.Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | Titre de la boîte de dialogue. |
prompt | String | Texte à afficher dans la boîte de dialogue. |
buttons | ButtonSet | Type de bouton défini à utiliser. |
Renvois
String : texte saisi par l'utilisateur (ou "annuler" pour une boîte de dialogue annulée ou fermée).
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msgBox(prompt)
Ouvre une boîte de dialogue contenant le message affiché et un bouton "OK" dans le navigateur de l'utilisateur.
La méthode msgBox génère une zone de message côté client qui affiche le message donné au utilisateur. Notez que cette méthode entraîne la suspension du script côté serveur. Reprise automatiquement après que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne persistent pas la suspension.
// The code below displays "hello world" in a dialog box with an OK button
Browser.msgBox('hello world');
Cette méthode n'est pas recommandée. Utilisez plutôt une boîte de dialogue Alerte dans l'interface utilisateur.Paramètres
| Nom | Type | Description |
|---|---|---|
prompt | String | Texte à afficher dans la boîte de dialogue. |
Renvois
String : texte en minuscules du bouton sur lequel l'utilisateur a cliqué (ou "annuler" pour un
boîte de dialogue fermée).
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msgBox(prompt, buttons)
Ouvre une boîte de dialogue contenant le message affiché et les boutons spécifiés dans le navigateur de l'utilisateur.
La méthode msgBox génère une zone de message côté client qui affiche le message donné au utilisateur et propose un choix de boutons à afficher. Notez que cette méthode entraîne script côté serveur soit suspendu. Elle reprend automatiquement après que l'utilisateur a effacé la boîte de dialogue, mais les connexions JDBC ne sont pas conservées.
// The code below displays "hello world" in a dialog box with OK and Cancel buttons.
Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);
Cette méthode n'est pas recommandée. Utilisez plutôt une boîte de dialogue Alerte dans l'interface utilisateur.Paramètres
| Nom | Type | Description |
|---|---|---|
prompt | String | Texte à afficher dans la boîte de dialogue. |
buttons | ButtonSet | Type de bouton défini à utiliser. |
Renvois
String : texte en minuscules du bouton sur lequel l'utilisateur a cliqué (ou "annuler" pour un
boîte de dialogue fermée).
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
msgBox(title, prompt, buttons)
Ouvre une boîte de dialogue contenant le titre, le message et les boutons spécifiés dans le navigateur de l'utilisateur.
La méthode msgBox génère une zone de message côté client portant le titre donné, qui affiche le message envoyé à l'utilisateur et propose un choix de boutons à afficher. Notez que cette entraîne la suspension du script côté serveur. Il est réactivé automatiquement une fois que l'utilisateur efface la boîte de dialogue, mais les connexions JDBC ne sont pas conservées pendant la suspension.
// 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);
Cette méthode n'est pas recommandée. Utilisez plutôt une boîte de dialogue Alerte dans l'interface utilisateur.Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | Titre de la boîte de dialogue. |
prompt | String | Texte à afficher dans la boîte de dialogue. |
buttons | ButtonSet | Type de bouton défini à utiliser. |
Renvois
String : texte en minuscules du bouton sur lequel l'utilisateur a cliqué (ou "annuler" pour un
boîte de dialogue fermée).
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets