Esta página foi traduzida pela API Cloud Translation.

Class Browser

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

Os métodos desta classe só estão disponíveis para uso no contexto de uma planilha do Google. Use as caixas de diálogo do Google Workspace.

Consulte também

ButtonSet

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`	Abre 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 fornecida e os botões especificados no navegador do usuário.
`msgBox(title, prompt, buttons)`	`String`	Abre uma caixa de diálogo com um título, uma 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 abre uma caixa de entrada do lado do cliente que exibe a solicitação fornecida ao usuário. Essa função faz com que o script do lado do servidor seja suspenso. Ela retoma automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não persistem 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 um comando da interface.

Parâmetros

Nome	Tipo	Descrição
`prompt`	`String`	Texto a ser exibido na caixa de diálogo.

Retornar

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 precisam de 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 abre uma caixa de entrada do lado do cliente que exibe a solicitação fornecida ao usuário e oferece várias opções de botões a serem exibidos. Essa função faz com que o que o script do lado do servidor seja suspenso. Ela retoma automaticamente depois que o usuário limpa a caixa de diálogo. mas as conexões JDBC não persistem 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 da interface.

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 para uso.

Retornar

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 precisam de 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 abre uma caixa de entrada no lado do cliente com o título fornecido, que exibe as fornecido ao usuário e oferece uma opção de botões a serem exibidos. Observe que este faz com que o script do lado do servidor seja suspenso. Ela retoma automaticamente após o usuário limpa a caixa de diálogo, mas as conexões JDBC não persistem 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 da interface.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	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 para uso.

Retornar

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 precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`msgBox(prompt)`

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

O método msgBox exibe uma caixa de mensagem do lado do cliente que exibe a mensagem dada para o usuário. Observe que esse método faz com que o script do lado do servidor seja suspenso. Ela retoma automaticamente depois que o usuário limpa a caixa de diálogo, mas as conexões JDBC não persistem 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 de interface.

Parâmetros

Nome	Tipo	Descrição
`prompt`	`String`	Texto a ser exibido na caixa de diálogo.

Retornar

String: o texto em letras minúsculas do botão que é clicado pelo usuário (ou "cancelar" para um caixa de diálogo dispensada).

Autorização

Os scripts que usam esse método precisam de 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 fornecida e os botões especificados no navegador do usuário.

O método msgBox exibe uma caixa de mensagem do lado do cliente que exibe a mensagem dada para o usuário e oferece várias opções de botões a serem exibidos. Observe que esse método faz com que a que o script do lado do servidor seja suspenso. Ela retoma automaticamente depois que o usuário limpa a caixa de diálogo. mas as conexões JDBC não persistem 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 de alerta de interface.

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 para uso.

Retornar

String: o texto em letras minúsculas do botão que é clicado pelo usuário (ou "cancelar" para um caixa de diálogo dispensada).

Autorização

Os scripts que usam esse método precisam de 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 um título, uma mensagem e os botões especificados no navegador do usuário.

O método msgBox abre uma caixa de mensagem no lado do cliente com o título fornecido, que exibe as determinada mensagem para o usuário e oferece uma opção de botões a serem exibidos. Observe que este faz com que o script do lado do servidor seja suspenso. Ela retoma automaticamente após o usuário limpa a caixa de diálogo, mas as conexões JDBC não persistem 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 de alerta de interface.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	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 para uso.

Retornar

String: o texto em letras minúsculas do botão que é clicado pelo usuário (ou "cancelar" para um caixa de diálogo dispensada).

Autorização

Os scripts que usam esse método precisam de autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets