set_tpositionset_tpositionSetTpositionSetTposition (Operator)

Name

set_tpositionset_tpositionSetTpositionSetTposition — Set the position of the text cursor.

Signature

Description

set_tpositionset_tpositionSetTpositionSetTpositionSetTposition 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_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString) or by an explicit change of position by (set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, new_linenew_lineNewLineNewLineNewLine). In order to stop the display of the cursor, the operator set_tshapeset_tshapeSetTshapeSetTshapeSetTshape with the parameter ”invisible” can be used.

Execution Information

• Multithreading type: reentrant (runs in parallel with non-exclusive operators).
• Multithreading scope: global (may be called from any thread).
• Processed without parallelization.

Parameters

Result

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

Possible Predecessors

open_windowopen_windowOpenWindowOpenWindowOpenWindow

Possible Successors

write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString

Alternatives

new_linenew_lineNewLineNewLineNewLine

See also

read_stringread_stringReadStringReadStringReadString, write_stringwrite_stringWriteStringWriteStringWriteString

Module

Foundation