Bezeichnung
ListRequest -- öffnet ein Dialogfenster mit einer Liste von Optionen (V5.0)
Übersicht
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. Das vierte Argument active ist optional und kann verwendet werden, um eine Option in der Liste voraus zu wählen. Übergeben Sie einfach den Index des vorab ausgewählten Eintrags als viertes Argument. Der Index beginnt für den ersten Eintrag bei 0 und durchläuft die Anzahl von Einträgen minus 1. Wenn das vierte Argument weggelassen wird oder es außerhalb des Bereiches ist, wird nichts ausgewählt werden.

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

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
active
optional: Index des Listeneintrags, der vorab ausgewählt ist (voreingestellt ist -1, was bedeutet, das vorher nichts ausgewählt ist)
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