User-Interface
Allgemeines
Bei verschiedenen Problemstellungen ist ein benutzerbezogener Eingriff in den Skriptablauf notwendig.
Dazu wird eine Sammlung verschiedenster GUI-Elemente zur Verfügung gestellt, die vor dem Start des Skripts
Werte abfragen können. Das Abfrageergebnis kann in Globalen Variablen
gespeichert und dann in den folgenden Schritten abgefragt werden.
//zuerst wird eine StartNummer vom Benutzer abgefragt...
$startNummer = new Gui LongField
name = "Startnummer für neue Punkte"
default = "1"
end
// ... und dann einem @Counter zugewiesen, der sie dann hochzählt
$nr = @Counter($startNummer)
Obiges Beispiel ergibt folgenden AbfrageDialog:
Der Dialog wird nach der Bestätigung des Buttons Ausführen aus dem Hauptprogramm heraus angezeigt. Wenn der Dialog mit OK
bestätigt wird, speichert GGMan den Wert aus dem Dialogfeld in der Variablen $startNummer.
GUI-Elemente können an belibiger Stelle im Skript vereinbart werden. GGMan setzt alle GUI-Elemente zusammen und fragt sie in einem Dialog
beim Programmstart ab. Das folgende Beispiel:
//Abfrage einer Ganzzahl
$startNummer = new Gui LongField
name = "Startnummer für neue Punkte"
default = "1"
end
//Abfrage eines Wahrheitswertes
$testAll = new Gui BooleanGroup
name = "Alle Daten testen?"
default = "true"
end
//Abfrage einer Zeichenkette
$testEb = new Gui StringGroup
name = "zu testende Ebene"
value = Ebene 1
value = Ebene 2
value = Ebene 3
value = Ebene 4
default = Ebene 3
end
ergibt einen zusammengesetzten Dialog:
GUI-Typen
GGMan unterscheidet auch hier wieder zwei wesentliche Typen von GUI-Elementen. In der Regel soll ein Wert vom Anwender abgefragt werden.
Dazu benutzt man GUI-Elemente mit einem Rückgabewert, sogenannte ValueGUIs. Für jeden der Typen stehen spezielle GUI-Elemente
zur Verfügung:
GUI-Elemente, die lediglich der Information des Anwenders dienen, haben keinen Rückgabewert, sie sind vom Typ Void.
- VoidGui
hat keinen Rückgabewert. Da die VoidGui keinen Rückgabewert hat, kann sie auch keiner Globalen Variablen zugewiesen werden.
GUIs allgemein
Alle GUIs
StringValue name: Der Name des GUI-Elements. In dem Abfragedialog wird dieser Name dem GUI-Element vorangestellt.
StringValue spec: Die Bedeutung des GUI-Elements. Dieser Parameter dient nur der Dokumentation und wird nicht dargestellt.
BooleanGui
LongGui
Fragt einen LongValue ab
LongValue value: Wenn GUI-Elemente Vorgabewerte erhalten sollen, werden diese hiermit vorgegeben.
LongValue default: Der Standardwert, den das GUI-Element erhalten soll.
DoubleGui
Fragt einen Wert ab
DoubleValue value: Wenn GUI-Elemente Vorgabewerte erhalten sollen, werden diese hiermit vorgegeben.
DoubleValue default: Der Standardwert, den das GUI-Element erhalten soll.
StringGui
Fragt einen StringValue ab
StringValue value: Wenn GUI-Elemente Vorgabewerte erhalten sollen, werden diese hiermit vorgegeben.
StringValue default: Der Standardwert, den das GUI-Element erhalten soll.
ObjectGui
Fragt einen ObjectValue ab
ObjectValue value: Wenn GUI-Elemente Vorgabewerte erhalten sollen, werden diese hiermit vorgegeben.
ObjectValue default: Der Standardwert, den das GUI-Element erhalten soll.
ArrayGui
VoidGui
Ein GUI-Element, welches nur der Benutzerinformation dient.
StringValue name: Der Name des GUI-Elements. Dieser Text wird in den Dialog dargestellt.
verfügbare GUIs
BooleanChoice
BooleanGui
Fragt einen BooleanValue ab.
$testAll = new Gui BooleanChoice
name = "Alle Daten testen"
default = "true"
end
BooleanGroup
BooleanGui
Fragt einen BooleanValue ab.
$testAll = new Gui BooleanGroup
name = "Alle Daten testen"
default = "true"
end
DoubleChoice
DoubleGui
Fragt einen DoubleValue aus einer Auswahl ab.
Damit steht dem Anwender nur eine begrenzte Anzahl von möglichen Werten zur Verfügung.
$testAll = new Gui DoubleChoice
name = "Abstand"
value = 1.0
value = 2.5
value = 25.35
value = 53.25
default = 2.5
end
DoubleField
DoubleGui
Fragt einen DoubleValue aus einem Eingabefeld ab.
Der Anwender kann einen beliebigen Fließkommawert eingeben.
$test = new Gui DoubleField
name = "Abstand"
default = "53.25"
end
FilePicker
StringGui
Fragt einen Dateinamen (StringValue) ab.
Der Anwender kann diesen über das Textfeld eingeben oder über das Auswahlbutton aus dem Filesystem auswählen.
$testFile = new Gui FilePicker
name = "Auswahldatei"
default = "C:\testDatei.out"
end
Label
VoidGui
Stellt eine Informationszeile in dem Abfragedialog zur Verfügung.
new Gui Label
name = "Der Datentest wird gestartet."
end
LabelBox
VoidGui
Stellt einen Informationstext in dem Abfragedialog zur Verfügung.
Lange Texte werden zur besseren Übersichtlichkeit auf mehrere Zeilen verteilt.
new Gui LabelBox
name = "Das ist eine Information mit sehr viel Inhalt. \
Dieser Text ist so lang, dass er nicht auf eine Zeile passt. \
GGMan verteilt ihn zur besseren Übersichtlichkeit auf mehrere Zeilen"
end
LongeChoice
LongGui
Fragt einen LongValue aus einer Auswahl ab.
Damit steht dem Anwender nur eine begrenzte Anzahl von möglichen Werten zur Verfügung.
$test = new Gui LongChoice
name = "zu wählende Art"
value = 1001
value = 2005
value = 3009
value = 2521
default = 3159
end
LongField
LongGui
Fragt einen LongValue aus einem Eingabefeld ab.
Der Anwender kann einen beliebigen Ganzzahlwert eingeben.
$test = new Gui LongField
name = "Geograf-Art"
default = "5201"
end
StringChoice
StringGui
Fragt einen StringValue aus einer Auswahl ab.
Damit steht dem Anwender nur eine begrenzte Anzahl von möglichen Werten zur Verfügung.
$testEb = new Gui StringChoice
name = "zu testende Ebene"
value = Ebene 1
value = Ebene 2
value = Ebene 3
value = Ebene 4
default = Ebene 3
end
StringField
StringGui
Fragt einen StringValue aus einem Eingabefeld ab.
Der Anwender kann eine beliebige Zeichenkette eingeben.
$test = new Gui StringField
name = "Textinhalt"
default = "ein Vorgabetext"
end
StringGroup
StringGui
Fragt einen StringValue aus einer Auswahl ab.
Damit steht dem Anwender nur eine begrenzte Anzahl von möglichen Werten zur Verfügung.
$testEb = new Gui StringGroup
name = "zu testende Ebene"
value = Ebene 1
value = Ebene 2
value = Ebene 3
value = Ebene 4
default = Ebene 3
end
GGMan
- Testen und Manipulieren von Geograf-Daten