set_tpositionset_tpositionset_tpositionSetTpositionSetTposition (Operator)

Name

set_tpositionset_tpositionset_tpositionSetTpositionSetTposition — Set the position of the text cursor.

Signature

Description

set_tpositionset_tpositionset_tpositionSetTpositionSetTposition sets the position of the text cursor in the output window. The reference position is the upper left corner of an upper case character.

The position is measured in the image coordinate system. 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 position is changed by the output or input of text (write_stringwrite_stringwrite_stringWriteStringWriteString, read_stringread_stringread_stringReadStringReadString) or by an explicit change of position by (set_tpositionset_tpositionset_tpositionSetTpositionSetTposition, new_linenew_linenew_lineNewLineNewLine). In order to stop the display of the cursor, the operator set_tshapeset_tshapeset_tshapeSetTshapeSetTshape with the parameter ”invisible” can be used.

Parallelization

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: local (may only be called from the same thread in which the window, model, or tool instance was created).
• Processed without parallelization.

Parameters

Result

set_tpositionset_tpositionset_tpositionSetTpositionSetTposition returns 2 (H_MSG_TRUE) if the window is valid. Otherwise an exception is raised.

Possible Predecessors

open_windowopen_windowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowopen_textwindowOpenTextwindowOpenTextwindow

Possible Successors

set_tshapeset_tshapeset_tshapeSetTshapeSetTshape, write_stringwrite_stringwrite_stringWriteStringWriteString, read_stringread_stringread_stringReadStringReadString

Alternatives

new_linenew_linenew_lineNewLineNewLine

See also

read_stringread_stringread_stringReadStringReadString, set_tshapeset_tshapeset_tshapeSetTshapeSetTshape, write_stringwrite_stringwrite_stringWriteStringWriteString

Module

Foundation