Esta classe fornece acesso a caixas de diálogo específicas do Planilhas Google.
Os métodos nesta classe só estão disponíveis para uso no contexto de uma planilha do Google. Use as caixas de diálogo do Google Workspace.
Veja também
Propriedades
Propriedade | Tipo | Descrição |
---|---|---|
Buttons | ButtonSet |
Métodos
Método | Tipo de retorno | Breve descrição |
---|---|---|
inputBox(prompt) | String | Abre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário. |
inputBox(prompt, buttons) | String | Abre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário. |
inputBox(title, prompt, buttons) | String | Abre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário. |
msgBox(prompt) | String | Exibe uma caixa de diálogo com a mensagem fornecida e um botão "OK" no navegador do usuário. |
msgBox(prompt, buttons) | String | Abre uma caixa de diálogo com a mensagem e os botões especificados no navegador do usuário. |
msgBox(title, prompt, buttons) | String | Abre uma caixa de diálogo com o título, a mensagem e os botões especificados no navegador do usuário. |
Documentação detalhada
inputBox(prompt)
Abre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
O método inputBox gera uma caixa de entrada do lado do cliente que mostra a solicitação fornecida para o usuário. Essa função faz com que o script do lado do servidor seja suspenso. Ela é retomada automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem durante a suspensão.
// The code below sets the value of name to the name input by the user, or 'cancel'. var name = Browser.inputBox('Enter your name');Esse método não é recomendado. Em vez disso, use um comando de IU.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
prompt | String | Texto a ser exibido na caixa de diálogo. |
Retorno
String
: o texto inserido pelo usuário (ou "cancelar" para uma caixa de diálogo cancelada ou dispensada).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
inputBox(prompt, buttons)
Abre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
O método inputBox gera uma caixa de entrada do lado do cliente que mostra a solicitação fornecida ao usuário e oferece uma opção de botões a serem mostrados. Essa função faz com que o script do lado do servidor seja suspenso. Ela é retomada automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem durante a suspensão.
// 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);Esse método não é recomendado. Em vez disso, use um comando de IU.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
prompt | String | Texto a ser exibido na caixa de diálogo. |
buttons | ButtonSet | O tipo de botão definido a ser usado. |
Retorno
String
: o texto inserido pelo usuário (ou "cancelar" para uma caixa de diálogo cancelada ou dispensada).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
inputBox(title, prompt, buttons)
Abre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
O método inputBox gera uma caixa de entrada do lado do cliente com o título fornecido, que mostra a solicitação fornecida para o usuário e oferece uma opção de botões a serem mostrados. Essa função faz com que o script do lado do servidor seja suspenso. Ela é retomada automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem durante a suspensão.
// 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);Esse método não é recomendado. Em vez disso, use um comando de IU.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
title | String | O título da caixa de diálogo. |
prompt | String | Texto a ser exibido na caixa de diálogo. |
buttons | ButtonSet | O tipo de botão definido a ser usado. |
Retorno
String
: o texto inserido pelo usuário (ou "cancelar" para uma caixa de diálogo cancelada ou dispensada).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
msgBox(prompt)
Exibe uma caixa de diálogo com a mensagem fornecida e um botão "OK" no navegador do usuário.
O método msgBox gera uma caixa de mensagem do lado do cliente que mostra a mensagem fornecida ao usuário. Esse método causa a suspensão do script do lado do servidor. Ela é retomada automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem durante a suspensão.
// The code below displays "hello world" in a dialog box with an OK button Browser.msgBox('hello world');Esse método não é recomendado. Em vez disso, use uma caixa de diálogo alerta da IU.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
prompt | String | Texto a ser exibido na caixa de diálogo. |
Retorno
String
: o texto em letras minúsculas do botão que é clicado pelo usuário (ou "cancelar" para uma
caixa de diálogo dispensada).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
msgBox(prompt, buttons)
Abre uma caixa de diálogo com a mensagem e os botões especificados no navegador do usuário.
O método msgBox gera uma caixa de mensagem do lado do cliente que mostra a mensagem fornecida ao usuário e oferece uma opção de botões a serem mostrados. Observe que esse método faz com que o script do lado do servidor seja suspenso. Ela é retomada automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem durante a suspensão.
// The code below displays "hello world" in a dialog box with OK and Cancel buttons. Browser.msgBox('hello world', Browser.Buttons.OK_CANCEL);Esse método não é recomendado. Em vez disso, use uma caixa de diálogo alerta da IU.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
prompt | String | Texto a ser exibido na caixa de diálogo. |
buttons | ButtonSet | O tipo de botão definido a ser usado. |
Retorno
String
: o texto em letras minúsculas do botão que é clicado pelo usuário (ou "cancelar" para uma
caixa de diálogo dispensada).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
msgBox(title, prompt, buttons)
Abre uma caixa de diálogo com o título, a mensagem e os botões especificados no navegador do usuário.
O método msgBox gera uma caixa de mensagem do lado do cliente com o título fornecido, que mostra a mensagem ao usuário e oferece uma opção de botões a serem mostrados. Observe que esse método faz com que o script do lado do servidor seja suspenso. Ela é retomada automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem durante a suspensão.
// 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);Esse método não é recomendado. Em vez disso, use uma caixa de diálogo alerta da IU.
Parâmetros
Nome | Tipo | Descrição |
---|---|---|
title | String | O título da caixa de diálogo. |
prompt | String | Texto a ser exibido na caixa de diálogo. |
buttons | ButtonSet | O tipo de botão definido a ser usado. |
Retorno
String
: o texto em letras minúsculas do botão que é clicado pelo usuário (ou "cancelar" para uma
caixa de diálogo dispensada).
Autorização
Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets