write_string
— Ausgabe von Text in ein Fenster.
write_string( : : WindowHandle, String : )
write_string
gibt im Ausgabefenster einen
String
aus, an der momentanen Textcursorposition.
Der auszugebende Text darf nicht länger als der bis zum rechten Fensterrand
verbleibende Platz sein (gegebenenfalls kann mit Hilfe des Operators
get_string_extents
die Länge des Strings abgefragt werden).
Bei der Ausgabe wird der gerade für das Fenster eingestellte Font verwendet. Der Textcursor steht im Anschluss an die Ausgabe hinter dem geschriebenen Text.
write_string
kann alle drei Datentypen ausgeben. Die
Konversion in eine Zeichenreihe erfolgt nach folgenden Regeln:
Strings werden unverändert übernommen.
Ganze Zahlen werden ohne Leerzeichen (vor, bzw. hinter der Zahl) konvertiert.
Gleitpunktzahlen werden, soweit möglich mit einem Gleitpunkt und ohne Exponent ausgegeben.
Die sich ergebenden Zeichenreihen werden ohne Leerzeichen hintereinander ausgegeben.
Für die Pufferung von Texten siehe set_system
mit dem Flag
'flush_graphic'.
Falls ein Klipping am Fensterrand erwünscht ist, kann die Fehlermeldung mit set_check('~text') ausgeschaltet werden.
WindowHandle
(input_control) window →
(handle)
Fenster-Handle.
String
(input_control) string(-array) →
(string / integer / real)
Tupel von auszugebenden Werten (beliebige Typen).
Defaultwert: 'hello'
write_string
liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig
ist und der auszugebende Text in der aktuellen Zeile noch Platz hat (siehe
set_check
).
Ansonsten wird eine Fehlerbehandlung durchgeführt.
open_window
,
set_font
,
get_string_extents
set_tposition
,
get_string_extents
,
set_font
,
set_system
,
set_check
Foundation