Esta página foi traduzida pela API Cloud Translation.

Class Browser

Essa classe fornece acesso a caixas de diálogo específicas das Planilhas Google.

Os métodos desta classe só estão disponíveis para uso no contexto de uma planilha 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`	Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
`inputBox(prompt, buttons)`	`String`	Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
`inputBox(title, prompt, buttons)`	`String`	Mostra uma caixa de diálogo com uma caixa de entrada de texto no navegador do usuário.
`msgBox(prompt)`	`String`	Mostra uma caixa de diálogo com a mensagem e um botão "OK" no navegador do usuário.
`msgBox(prompt, buttons)`	`String`	Mostra uma caixa de diálogo com a mensagem e os botões especificados no navegador do usuário.
`msgBox(title, prompt, buttons)`	`String`	Mostra 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)`

Mostra 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 o comando fornecido ao usuário. Essa função suspende o 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 são mantidas durante a suspensão.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox('Enter your name');

Esse método não é recomendado. Em vez disso, use uma sugestão de interface.

Parâmetros

Nome	Tipo	Descrição
`prompt`	`String`	O texto que 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 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)`

Mostra 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 o comando fornecido 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. Ela é retomada 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'.
const name = Browser.inputBox('Enter your name', Browser.Buttons.OK_CANCEL);

Esse método não é recomendado. Em vez disso, use uma sugestões de interface.

Parâmetros

Nome	Tipo	Descrição
`prompt`	`String`	O texto que 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 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)`

Mostra 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 exibe o prompt fornecido para o usuário e oferece uma escolha de botões a serem exibidos. 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 persistem durante a suspensão.

// The code below sets the value of name to the name input by the user, or
// 'cancel'.
const name = Browser.inputBox(
    'ID Check',
    'Enter your name',
    Browser.Buttons.OK_CANCEL,
);

Esse método não é recomendado. Em vez disso, use uma sugestões de interface.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O título da caixa de diálogo.
`prompt`	`String`	O texto que 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 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)`

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

O método msgBox gera uma caixa de mensagem do lado do cliente que exibe a mensagem determinada para o usuário. Esse método suspende o 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 são mantidas 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 de alerta da interface.

Parâmetros

Nome	Tipo	Descrição
`prompt`	`String`	O texto que será exibido na caixa de diálogo.

Retornar

String: o texto em letras minúsculas do botão 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)`

Mostra 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 ao 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. Ela é retomada 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 da interface.

Parâmetros

Nome	Tipo	Descrição
`prompt`	`String`	O texto que 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 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)`

Mostra 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 exibidos. Esse método 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 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 da interface.

Parâmetros

Nome	Tipo	Descrição
`title`	`String`	O título da caixa de diálogo.
`prompt`	`String`	O 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 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