Class PromptResponse

PromptResponse

Uma resposta a uma caixa de diálogo prompt exibida no ambiente de interface do usuário de um Google app. A resposta contém qualquer texto digitado pelo usuário 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()StringAcessa o texto digitado pelo usuário no campo de entrada do diálogo.
getSelectedButton()ButtonRecebe o botão em que o usuário clicou para dispensar a caixa de diálogo.

Documentação detalhada

getResponseText()

Acessa o texto digitado pelo usuário no campo de entrada do diálogo. O texto estará disponível mesmo que o usuário feche a caixa de diálogo clicando em um botão com conotação negativa, como "Cancelar" ou no botão de fechar na barra de título da caixa de diálogo. getSelectedButton() pode ajudar a determinar se o usuário pretendia que o texto da resposta seja válido.

Retornar

String: o texto inserido pelo usuário 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 tiver clicado no botão fechar incluído em cada barra de título da caixa de diálogo, esse método retornará Button.CLOSE.

Retornar

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