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étodo | Tipo de retorno | Breve descrição |
---|---|---|
getResponseText() | String | Extrai o texto que o usuário digitou no campo de entrada da caixa de diálogo. |
getSelectedButton() | Button | Extrai 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.