Eine Antwort auf ein prompt
-Dialogfeld, das in der Benutzeroberfläche einer Google-App angezeigt wird. Die Antwort enthält den Text, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat, und gibt an, auf welche Schaltfläche der Nutzer geklickt hat, um das Dialogfeld zu schließen.
// 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. const ui = DocumentApp.getUi(); const 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.'); }
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
get | String | Der Text, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat. |
get | Button | Die Schaltfläche, auf die der Nutzer geklickt hat, um das Dialogfeld zu schließen. |
Detaillierte Dokumentation
get Response Text()
Der Text, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat. Der Text ist auch dann verfügbar, wenn der Nutzer das Dialogfeld durch Klicken auf eine Schaltfläche mit negativer Konnotation geschlossen hat, z. B. „Abbrechen“ oder die Schaltfläche zum Schließen in der Titelleiste des Dialogfelds. Anhand von get
lässt sich feststellen, ob der Nutzer beabsichtigt hat, dass der Antworttext gültig ist.
Rückflug
String
: Der Text, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat.
get Selected Button()
Die Schaltfläche, auf die der Nutzer geklickt hat, um das Dialogfeld zu schließen. Wenn der Nutzer auf die Schaltfläche „Schließen“ geklickt hat, die in der Titelleiste jedes Dialogfelds enthalten ist, gibt diese Methode Button.CLOSE
zurück.
Rückflug
Button
: Die Schaltfläche, auf die der Nutzer geklickt hat.