Class PromptResponse

Resposta imediata

Uma resposta a uma caixa de diálogo prompt exibida no ambiente da interface do usuário de um app do Google. A resposta contém qualquer texto que o usuário digitou no campo de entrada da caixa de diálogo e indica em qual botão o usuário clicou para dispensar a caixa de diálogo.

// Display a dialog box with a title, message, input field, and "Yes" and "No"
// buttons. The user can also close the dialog by clicking the close button in
// its title bar.
const ui = DocumentApp.getUi();
const response = ui.prompt(
    'Getting to know you',
    'May I know your name?',
    ui.ButtonSet.YES_NO,
);

// Process the user's response.
if (response.getSelectedButton() === ui.Button.YES) {
  Logger.log('The user\'s name is %s.', response.getResponseText());
} else if (response.getSelectedButton() === ui.Button.NO) {
  Logger.log('The user didn\'t want to provide a name.');
} else {
  Logger.log('The user clicked the close button in the dialog\'s title bar.');
}

Métodos

Método	Tipo de retorno	Breve descrição
getResponseText()	String	Recebe o texto que o usuário digitou no campo de entrada da caixa de diálogo.
getSelectedButton()	Button	Recebe o botão em que o usuário clicou para dispensar a caixa de diálogo.

Documentação detalhada

getResponseText()

Recebe o texto que o usuário digitou no campo de entrada da caixa de diálogo. O texto fica disponível mesmo se o usuário fechar a caixa de diálogo clicando em um botão com uma conotação negativa, como "Cancelar" ou o botão de fechamento na barra de título da caixa de diálogo. O getSelectedButton() pode ajudar a determinar se o usuário pretendia que o texto da resposta fosse válido.

Retornar

String: o texto que o usuário digitou no campo de entrada da caixa de diálogo.

---

getSelectedButton()

Recebe o botão em que o usuário clicou para dispensar a caixa de diálogo. Se o usuário clicar no botão de fechar incluído na barra de título de cada caixa de diálogo, esse método retornará Button.CLOSE.

Retornar

Button: o botão em que o usuário clicou.