set_tposition ( : : Row, Column : )

Sets the position of the text cursor.

set_tposition sets the position of the text cursor in the current output window. The position is measured in the coordinate system of the current window and has to be valid for the current window size and font. The position of the text cursor can be marked e.g. by an underscore. The next text output in this window starts at the cursor position. The left end of the baseline for writing the following text string (not considering descenders) is placed on this position. The cursor is assigned to the window and does not change if a switch of the current output window occurs. 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, new_line). In order to stop the display of the cursor, the procedure set_tshape with the parameter 'invisible' can be used.


Attention

If a string starting at the given position does not fit into the window an exception will be raised. This exception can be avoided by set_check(::'~text':).


Parameters

Row (input_control)
point.y -> integer
row index of text cursor position.
Default value: 24

Column (input_control)
point.x -> integer
column index of text cursor position.
Default value: 12


Result

set_tposition returns TRUE, if a window is activated and the values of the parameters are valid. Otherwise an exception is raised.


Possible Predecessors

open_window, set_window, open_textwindow


Possible Successors

set_tshape, write_string, read_string


Alternatives

new_line


See also

read_string, set_tshape, write_string



Copyright © 1996-1997 MVTec Software GmbH