Class Browser

Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.
Navegador

Esta turma fornece acesso a caixas de diálogo específicas do Planilhas Google.

Os métodos desta classe estão disponíveis apenas 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)StringPop-up de uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(prompt, buttons)StringPop-up de uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
inputBox(title, prompt, buttons)StringPop-up de uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
msgBox(prompt)StringPop-up de uma caixa de diálogo com a mensagem fornecida e um botão de OK no navegador do usuário.
msgBox(prompt, buttons)StringPop-up de uma caixa de diálogo com a mensagem especificada e os botões especificados no navegador do usuário.
msgBox(title, prompt, buttons)StringPop-up de 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)

Pop-up de 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 no lado do cliente que exibe a solicitação em questão para o usuário. Essa função faz com que o script do lado do servidor seja suspenso. Ele é retomado automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem na 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 uma solicitação de IU.

Parâmetros

NomeTipoDescrição
promptStringO texto a ser exibido na caixa de diálogo.

Retornar

String: o texto inserido pelo usuário (ou 'cancel' 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)

Pop-up de 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 exibe a solicitação em questão para o usuário e oferece uma opção de botões a serem exibidos. Essa função faz com que o script do lado do servidor seja suspenso. Ele será retomado automaticamente depois que o usuário limpar a caixa de diálogo, mas as conexões JDBC não permanecem na 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 uma solicitação de IU.

Parâmetros

NomeTipoDescrição
promptStringO texto a ser exibido na caixa de diálogo.
buttonsButtonSetO tipo de botão definido para usar.

Retornar

String: o texto inserido pelo usuário (ou 'cancel' 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)

Pop-up de 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 no lado do cliente com o título fornecido, que exibe a solicitação especificada ao usuário e oferece uma opção de botões a serem exibidos. Essa função faz com que o script do lado do servidor seja suspenso. Ele será retomado automaticamente depois que o usuário limpar a caixa de diálogo, mas as conexões JDBC não persistirem na 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 uma solicitação de IU.

Parâmetros

NomeTipoDescrição
titleStringO título da caixa de diálogo.
promptStringO texto a ser exibido na caixa de diálogo.
buttonsButtonSetO tipo de botão definido para usar.

Retornar

String: o texto inserido pelo usuário (ou 'cancel' 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)

Pop-up de uma caixa de diálogo com a mensagem fornecida e um botão de OK no navegador do usuário.

O método msgBox gera uma caixa de mensagem no lado do cliente que exibe a mensagem especificada para o usuário. Esse método suspende o script do lado do servidor. Ele é retomado automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não permanecem na 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 de alerta da IU.

Parâmetros

NomeTipoDescrição
promptStringO texto a ser exibido na caixa de diálogo.

Retornar

String: o texto em letras minúsculas do botão clicado pelo usuário (ou 'cancel' 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)

Pop-up de uma caixa de diálogo com a mensagem especificada e os botões especificados no navegador do usuário.

O método msgBox gera uma caixa de mensagem no lado do cliente que exibe a mensagem especificada para o usuário e oferece uma opção de botões a serem exibidos. Esse método faz com que o script do lado do servidor seja suspenso. Ele será retomado automaticamente depois que o usuário limpar a caixa de diálogo, mas as conexões JDBC não permanecem na 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 de alerta da IU.

Parâmetros

NomeTipoDescrição
promptStringO texto a ser exibido na caixa de diálogo.
buttonsButtonSetO tipo de botão definido para usar.

Retornar

String: o texto em letras minúsculas do botão clicado pelo usuário (ou 'cancel' 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)

Pop-up de 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 cliente com o título informado, que exibe a mensagem especificada ao usuário e oferece uma opção de botões a serem exibidos. Esse método suspende o script do lado do servidor. Ele será retomado automaticamente depois que o usuário limpar a caixa de diálogo, mas as conexões JDBC não persistirem na 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 de alerta da IU.

Parâmetros

NomeTipoDescrição
titleStringO título da caixa de diálogo.
promptStringO texto a ser exibido na caixa de diálogo.
buttonsButtonSetO tipo de botão definido para usar.

Retornar

String: o texto em letras minúsculas do botão clicado pelo usuário (ou 'cancel' 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