| Operatoren |
read_string — Einlesen eines Strings in einem Textfenster.
read_string( : : WindowHandle, InString, Length : OutString)
read_string liest im Eingabefenster (= Ausgabefenster) einen String mit vorgegebener Maximallänge (Length) von der Tastatur ein. Der String wird ab der momentanen Textcursorposition des Fensters unter Verwendung des eingestellten Fonts eingelesen. Die Maximallänge (Length) muss so gewählt sein, dass der rechte Rand des Fensters nicht überschritten wird. Der Operator kann ein Default-String (InString) übergeben werden, der vom Benutzer editiert oder direkt übernommen werden kann. Der Textcursor befindet sich nach Beendigung der Eingabe am Ende des editierten Strings. Editiermöglichkeiten:
Eingabe abschließen
Zeichen links vom Cursor löschen und Textcursor um eine Position nach links.
Wurde die globale Variable 'filename_encoding' mit set_system auf 'utf8' gesetzt, erwartet read_string, dass InString in UTF-8 kodiert ist und gibt OutString UTF-8 kodiert zurück.
Fenster-Handle.
String, der vor dem Einlesen bereits sichtbar ist.
Defaultwert: ''
Maximale Anzahl von Zeichen.
Defaultwert: 32
Restriktion: Length > 0 && Length <= 1024
Eingelesener String.
read_string liefert den Wert 2 (H_MSG_TRUE), falls das Textfenster gültig ist und ein String mit maximaler Länge bis zum rechten Fensterrand Platz hat. Ansonsten wird eine Fehlerbehandlung durchgeführt.
read_char, fread_string, fread_char
set_tposition, new_line, open_window, set_font, set_color
Foundation
| Operatoren |