Class PromptResponse

PromptResponse

Eine Antwort auf ein prompt-Dialogfeld, das in der Benutzeroberflächenumgebung 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
getResponseText()	String	Ruft den Text ab, den der Nutzer in das Eingabefeld des Dialogfelds eingegeben hat.
getSelectedButton()	Button	Ruft 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 einer negativen Konnotation geklickt hat, z. B. „Abbrechen“ oder die Schaltfläche „Schließen“ in der Titelleiste des Dialogfelds. Mit getSelectedButton() lässt sich feststellen, ob der Nutzer beabsichtigt hat, dass der Antworttext gültig ist.

Rückgabe

String : Der 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 Schaltfläche „Schließen“ geklickt hat, die in der Titelleiste jedes Dialogfelds enthalten ist, gibt diese Methode Button.CLOSE zurück.

Rückgabe

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