Class PromptResponse

PromptResponse

Eine Antwort auf ein prompt-Dialogfeld, das in der Benutzeroberfläche einer Google-Anwendung angezeigt wird. Die Antwort enthält beliebigen Text, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat, und gibt an, auf welche Schaltfläche der Nutzer zum Schließen des Dialogfelds geklickt hat.

// 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.');
}

Methoden

MethodeRückgabetypKurzbeschreibung
getResponseText()StringRuft den Text ab, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat.
getSelectedButton()ButtonRuft die Schaltfläche ab, auf die der Nutzer geklickt hat, um das Dialogfeld zu schließen.

Detaillierte Dokumentation

getResponseText()

Ruft den Text ab, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat. Der Text ist auch dann verfügbar, wenn der Nutzer das Dialogfeld geschlossen hat, indem er auf eine Schaltfläche mit negativer Bedeutung wie „Abbrechen“ oder auf die Schaltfläche „Schließen“ in der Titelleiste des Dialogfelds geklickt hat. Mit getSelectedButton() lässt sich feststellen, ob der Nutzer den Antworttext als gültig erachtet hat.

Return

String: Text, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat.


getSelectedButton()

Ruft die Schaltfläche ab, auf die der Nutzer geklickt hat, um das Dialogfeld zu schließen. Wenn der Nutzer auf die Schließen-Schaltfläche in der Titelleiste jedes Dialogfelds geklickt hat, gibt diese Methode Button.CLOSE zurück.

Return

Button: Die Schaltfläche, auf die der Nutzer geklickt hat.