Bezeichnung
ListRequest -- öffnet ein Dialogfenster mit einer Liste von Optionen (V5.0)
Übersicht
choice = ListRequest(title$, body$, choices[, t])
Frühere syntax
choice = ListRequest(title$, body$, choices[, active])
Beschreibung
Dieser Befehl kann verwendet werden, um eine Liste von Optionen für den Benutzer zu präsentieren und fordert ihn auf, einen der Listeneinträge auszuwählen. Das erste Argument title$ ist der Titeltext für das Dialogfenster. Das zweite Argument body$ gibt den Haupttext an, der über der Auswahlliste erscheinen soll. Das dritte Argument choices muss eine Tabelle sein, die eine beliebige Anzahl von Zeichenketten enthält, aus der der Anwender wählen kann.

In choice wird der Benutzer den Index des Listeneintrags als Rückgabewert erhalten, den er ausgewählt hat. Wenn der Benutzer kein Element auswählt oder er bricht den Dialog ab, wird -1 zurückgegeben.

ListRequest() unterstützt mehrere zusätzliche 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 ListRequest() übergeben werden können.

Die folgenden Tabellenfelder werden von diesem Befehl erkannt:

Active:
Mit diesem Tabellen-Tag kann eine der Auswahlmöglichkeiten in der Liste vorab ausgewählt werden. Übergeben Sie einfach den Index des Eintrags zur Vorauswahl im Tabellen-Tag Active. Indizes beginnen bei 0 für den ersten Eintrag und durchlaufen die Anzahl der Einträge minus 1. Wird Active weggelassen oder ist außerhalb des Bereichs, wird nichts vorausgewählt.

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

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

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

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

Ab 6.0 können Sie eine leere Zeichenfolge ("") im Parameter title$ weitergeben. In diesem Fall wird das Dialogfenster den Titel aus der angegebenen Präprozessor-Anweisung @APPTITLE verwenden.

Eingaben
title$
Titel des Dialogfensters
body$
Haupttext, der über der Listenansicht angezeigt wird
choices
Tabelle, die eine Reihe von Zeichenketteneinträge der verfügbaren Optionen darstellt
t
optional: Tabelle mit weiteren Argumenten (siehe oben) (V9.0)
Rückgabewerte
choice
Index der Benutzerauswahl oder -1, wenn der Benutzer den Dialog abbricht; der erste Eintrag beginnt bei 0 und endet bei der Anzahl der Einträge minus 1.
Beispiel
r = ListRequest("User prompt", "Which of these is not an island?",
{"Australia", "Fiji", "New Zealand", "Easter Island", "Hawaii",
"Goa", "Madagascar", "Maldives", "Seychelles"})
If r = -1
  Print("You chose the chicken exit!")
ElseIf r = 5
  Print("That's right, congratulations!")
Else
  Print("Sorry, but that is an island...")
EndIf
Der obige Code zeigt, wie ListRequest() für ein kleines Quiz verwenden werden kann.

Navigation zeigen