Class PromptResponse

PromptAntwort

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

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

Detaillierte Dokumentation

getResponseText()

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 getSelectedButton() 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.


getSelectedButton()

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.