Herror ::new_line (
    const HTuple &WindowHandle
)
void HWindow::NewLine (
    
) const

Set the position of the text cursor to the beginning of the next line.

::new_line sets the position of the text cursor to the beginning of the next line. The new position depends on the current font. The left end of the baseline for writing the following text string (not considering descenders) is placed on this position.

If the next line does not fit into the window the content of the window is scrolled by the height of one line in the upper direction. In order to reach the correct new cursor position the font used in the next line must be set before ::new_line is called. The position is changed by the output or input of text (::write_string, ::read_string) or by an explicit change of position by (::set_tposition).


Parameters

WindowHandle (input_control)
window -> HTuple.long
Window identifier.


Result

::new_line returns H_MSG_TRUE if the window is valid. Otherwise an exception handling is raised.


Possible Predecessors

::open_window, ::open_textwindow, ::set_font, ::write_string


Alternatives

::get_tposition, ::get_string_extents, ::set_tposition, ::move_rectangle


See also

::write_string, ::set_font


Module

System



Copyright © 1996-2002 MVTec Software GmbH