write_stringT_write_stringWriteStringWriteStringwrite_string (Operator)

Name

write_stringT_write_stringWriteStringWriteStringwrite_string — Ausgabe von Text in ein Fenster.

Signatur

write_string( : : WindowHandle, String : )

Beschreibung

write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string gibt im Ausgabefenster einen StringStringStringStringstringValstring 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_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtentsget_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_stringwrite_stringWriteStringWriteStringWriteStringwrite_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_systemset_systemSetSystemSetSystemSetSystemset_system mit dem Flag 'flush_graphic'.

Achtung

Falls ein Clipping am Fensterrand erwünscht ist, kann die Fehlermeldung mit set_check('~text')set_check("~text")SetCheck("~text")SetCheck("~text")SetCheck("~text")set_check("~text") ausgeschaltet werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Fenster-Handle.

StringStringStringStringstringValstring (input_control) string(-array) → (string / integer / real)

Tupel von auszugebenden Werten (beliebige Typen).

Defaultwert: 'hello' "hello" "hello" "hello" "hello" "hello"

Ergebnis

write_stringwrite_stringWriteStringWriteStringWriteStringwrite_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_checkset_checkSetCheckSetCheckSetCheckset_check). Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window, set_fontset_fontSetFontSetFontSetFontset_font, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtentsget_string_extents

Alternativen

fwrite_stringfwrite_stringFwriteStringFwriteStringFwriteStringfwrite_string

Siehe auch

set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtentsget_string_extents, set_fontset_fontSetFontSetFontSetFontset_font, set_systemset_systemSetSystemSetSystemSetSystemset_system, set_checkset_checkSetCheckSetCheckSetCheckset_check

Modul

Foundation

Operatoren