Class PromptResponse

PromptResponse

Uma resposta a uma caixa de diálogo prompt exibida no ambiente da interface do usuário de um Google app. A resposta contém qualquer texto que o usuário inseriu 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.
var ui = DocumentApp.getUi();
var 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étodoTipo de retornoBreve descrição
getResponseText()StringExtrai o texto que o usuário digitou no campo de entrada da caixa de diálogo.
getSelectedButton()ButtonExtrai o botão em que o usuário clicou para dispensar a caixa de diálogo.

Documentação detalhada

getResponseText()

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

Retorno

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


getSelectedButton()

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

Retorno

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