Uma resposta a uma caixa de diálogo prompt exibida na
da interface do usuário de um app do Google. A resposta contém o texto digitado pelo usuário
campo de entrada da caixa de diálogo e indica em qual botão o usuário clicou para fechá-la.
// 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 inseriu 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()
Extrai o texto que o usuário inseriu no campo de entrada da caixa de diálogo. O texto estará disponível mesmo se
o usuário fechou a caixa de diálogo clicando em um botão com uma conotação negativa, como "Cancelar" ou
botão Fechar 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 inseriu 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 clicou no botão Fechar
incluído na barra de título de todas as caixas de diálogo, esse método retorna Button.CLOSE.
Retornar
Button: o botão em que o usuário clicou.