Class Browser

Navegador

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

PropriedadeTipoDescrição
ButtonsButtonSet

Métodos

MétodoTipo de retornoBreve descrição
inputBox(prompt)StringAbre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(prompt, buttons)StringAbre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(title, prompt, buttons)StringAbre uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
msgBox(prompt)StringExibe uma caixa de diálogo com a mensagem fornecida e um botão "OK" no navegador do usuário.
msgBox(prompt, buttons)StringAbre uma caixa de diálogo com a mensagem e os botões especificados no navegador do usuário.
msgBox(title, prompt, buttons)StringAbre 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

NomeTipoDescrição
promptStringTexto 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

NomeTipoDescrição
promptStringTexto a ser exibido na caixa de diálogo.
buttonsButtonSetO 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

NomeTipoDescrição
titleStringO título da caixa de diálogo.
promptStringTexto a ser exibido na caixa de diálogo.
buttonsButtonSetO 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

NomeTipoDescrição
promptStringTexto 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

NomeTipoDescrição
promptStringTexto a ser exibido na caixa de diálogo.
buttonsButtonSetO 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

NomeTipoDescrição
titleStringO título da caixa de diálogo.
promptStringTexto a ser exibido na caixa de diálogo.
buttonsButtonSetO 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