Das UI-Objekt stellt Funktionen zur Interaktion mit dem Benutzer sowie zur Abfrage und Anzeige von grundlegenden Informationen bereit. Das UI-Objekt ist in Ihrem Makro automatisch als ui-Variable verfügbar.
HINWEIS:Wichtig! Allen UI-Funktionen muss das yield-Schlüsselwort voranstehen. Dadurch kann das Makro die Ausführung blockieren, bis die Bedingungen der UI-Funktion erfüllt wurden.
[parameter] Kennzeichnet einen optionalen Parameter.
Tabelle 5-35 Benutzerinteraktion
METHODEN |
|
---|---|
prompt(message,[defaultAnswer], [mask]) |
Fragt von Benutzern Informationen auf der Benutzeroberfläche ab. Parameter {String} Meldungstitel, der Benutzern angezeigt werden soll. Standard: Leere Zeichenfolge. {String} Standardantwort, wenn der Benutzer die Zeichenfolge leer lässt. Standard: Leere Zeichenfolge. {Boolean} Maske, die anzeigt, ob die Aufforderung ausgeblendet werden soll (wie bei einem Passwort). Ausgabe {Promise} Wird ausgeführt, wenn der Benutzer das Dialogfeld schließt. Bei „OK“ wird eine Benutzereingabe zurückgegeben, „Abbrechen“ ergibt Null. |
message([message]) |
Zeigt eine Meldung auf der Benutzeroberfläche an. Parameter {String} Meldung, die dem Benutzer angezeigt werden soll. Standard: Leere Zeichenfolge. Ausgabe {Promise} Wird ausgeführt, wenn der Benutzer das Meldungsfenster schließt. |