Bezeichnung
StringRequest -- bittet den Benutzer eine Zeichenkette einzugeben (V2.0)
Übersicht
s$, ok = StringRequest(title$, body$[, t])
Frühere syntax
s$, ok = StringRequest(title$, body$[, def$, type, maxchars, password])
Beschreibung
Dieser Befehl öffnet ein Dialogfenster, welches den Benutzer auffordert, eine Zeichenkette einzugeben. Sie können den Titel für das Zeichenketten-Dialogfenster in title$ und den Haupttext in body$ angeben. Wenn Sie eine leere Zeichenfolge ("") in title$ übergeben, verwendet das Zeichenketten-Dialogfenster den in der Präprozessor-Anweisung @APPTITLE angegebenen Titel.

StringRequest() gibt den vom Benutzer eingegebene Zeichenkette in s$ zurück, wenn der Benutzer das Zeichenketten-Dialogfenster bestätigt. Wenn der Benutzer diesen Dialog abbricht, wird eine leere Zeichenkette zurückgegeben. Mit dem zweiten Rückgabewert ok können Sie feststellen, ob der Benutzer die Schaltfläche 'OK' gedrückt hat oder nicht. Dies ist normalerweise nur erforderlich, wenn Ihr Programm eine leere Zeichenkette bei 'OK' zulässt. In diesem Fall müssen Sie auch den zweiten Rückgabewert überprüfen.

StringRequest() unterstützt mehrere optionale Argumente. Vor Hollywood 9.0 mussten diese als optionale Parameter übergeben werden (siehe oben). Seit Hollywood 9.0 wird jedoch empfohlen, die neue Syntax zu verwenden, die ein einzelnes optionales Tabellenargument hat, mit dem ein oder mehrere optionale Argumente an StringRequest() übergeben werden können.

Die folgenden Tabellenfelder werden von diesem Befehl erkannt:

Type:
Mit diesem Tabellen-Tag kann festgelegt werden, welche Zeichen der Benutzer eingeben darf. Dies kann derzeit #NUMERICAL nur für Zahlen oder #ALL für keine Beschränkung der eingebbaren Zeichen sein. Die Voreinstellung ist #ALL.

Password:
Setzen Sie diesen Tabellen-Tag auf True, um den Dialog in den Passwortmodus zu versetzen. In diesem Fall wird die Eingabe des Benutzers ausgeblendet. Der Standardwert ist False.

MaxLength:
Dieser Tabellen-Tag kann verwendet werden, um die Anzahl der Zeichen anzugeben, die der Benutzer eingeben darf. Der Standardwert ist 0, was bedeutet, dass die Anzahl der Zeichen, die der Benutzer eingeben kann, unbegrenzt ist.

Text:
Dieser Tabellen-Tag kann verwendet werden, um den Standardtext für das Zeichenketten-Dialogfenster anzugeben. Der hier angegebene Text wird zunächst im Texteingabe-Widget des Zeichenketten-Dialogfenster angezeigt.

X:
Anfängliche x-Position für das Zeichenketten-Dialogfenster auf dem Bildschirm. Nicht alle Plattformen unterstützen dies. (V9.0)

Y:
Anfängliche y-Position für das Zeichenketten-Dialogfenster auf dem Bildschirm. Nicht alle Plattformen unterstützen dies. (V9.0)

Width:
Anfängliche Breite für das Zeichenketten-Dialogfenster. Nicht alle Plattformen unterstützen dies. (V9.0)

Height:
Anfängliche Höhe für das Zeichenketten-Dialogfenster. Nicht alle Plattformen unterstützen dies. (V9.0)

Bitte beachten Sie, dass dieser Befehl die Installation der reqtools.library auf AmigaOS 3, MorphOS und AROS erfordert. Unter AmigaOS 4 funktioniert der StringRequest() ohne die reqtools.library.

Eingaben
title$
Titel für das Dialogfenster
body$
Text für den Haupttext
t
optional: Tabelle mit weiteren Argumenten (siehe oben) (V9.0)
Rückgabewerte
s$
die Zeichenfolge, die vom Benutzer eingegeben wurde oder "", wenn der Dialog abgebrochen wurde
ok
True wenn der Benutzer die Schaltfläche "OK" drückt, sonst False (V4.5)
Beispiel
a$ = StringRequest("My Program", "Please enter your name!")
Print("Hello,", a$, "!")
Der Code fragt den Benutzer nach seinem Namen und gibt diesen aus.

Navigation zeigen