new_lineT_new_lineNewLineNewLine (Operator)

Name

new_lineT_new_lineNewLineNewLine — Ausgabe eines Zeilenvorschubs im Ausgabefenster.

Signatur

new_line( : : WindowHandle : )

Herror T_new_line(const Htuple WindowHandle)

void NewLine(const HTuple& WindowHandle)

void HWindow::NewLine() const

static void HOperatorSet.NewLine(HTuple windowHandle)

void HWindow.NewLine()

Beschreibung

new_linenew_lineNewLineNewLineNewLine 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_lineNewLineNewLineNewLine 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_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString) und durch explizite Neupositionierung (set_tpositionset_tpositionSetTpositionSetTpositionSetTposition).

Ausführungsinformationen

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Fenster-Handle.

Ergebnis

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

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_fontset_fontSetFontSetFontSetFont, write_stringwrite_stringWriteStringWriteStringWriteString

Alternativen

get_tpositionget_tpositionGetTpositionGetTpositionGetTposition, get_string_extentsget_string_extentsGetStringExtentsGetStringExtentsGetStringExtents, set_tpositionset_tpositionSetTpositionSetTpositionSetTposition

Siehe auch

write_stringwrite_stringWriteStringWriteStringWriteString, set_fontset_fontSetFontSetFontSetFont

Modul

Foundation