User Interface

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.