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étodo | Tipo de retorno | Breve descrição |
---|---|---|
getResponseText() | String | Acessa o texto digitado pelo usuário no campo de entrada do 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()
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.