new_linenew_lineNewLinenew_lineNewLineNewLine (Operator)

Name

new_linenew_lineNewLinenew_lineNewLineNewLine — Ausgabe eines Zeilenvorschubs im Ausgabefenster.

new_linenew_lineNewLinenew_lineNewLineNewLine setzt die Position des Textcursors im Ausgabefenster in Abhängigkeit vom momentan eingestellten Font auf den Anfang der nächsten Zeile. Die nächste Textausgabe auf dieses Fenster erfolgt ab der Cursorposition, wobei die Cursorposition die linke Ecke der Schreiblinie des auszugebenden Textes (d.h. ohne Berücksichtigung von Unterlängen) bezeichnet.

Falls im Fenster keine weitere Zeile mehr Platz hat, weil der untere Fensterrand erreicht ist, wird der Inhalt des Fensters um eine Zeilenhöhe nach oben geschoben („gescrolt“). Damit die Neupositionierung in der nächsten Zeile korrekt erfolgt, muss beim Aufruf von new_linenew_lineNewLinenew_lineNewLineNewLine schon der für die nächste Ausgabe gewünschte Font eingestellt sein. Die Cursorposition verändert sich bei der Ausgabe bzw. Eingabe von Text (write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString) und durch explizite Neupositionierung (set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition).

Parallelisierung

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

Parameter

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Fenster-Handle.

Ergebnis

new_linenew_lineNewLinenew_lineNewLineNewLine liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.