get_tpositionT_get_tpositionGetTpositionGetTpositionget_tposition (Operator)
Name
get_tpositionT_get_tpositionGetTpositionGetTpositionget_tposition — Get cursor position.
Signature
Description
get_tpositionget_tpositionGetTpositionGetTpositionGetTpositionget_tposition queries the current position of the text
cursor in the output window. The position is measured in the image
coordinate system. The next output of text in this window starts at
the cursor position. The left end of the baseline for writing the
next string (not considering descenders) is placed on this
position. The position is changed by the output or input of text
(write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringReadStringread_string) or by an explicit change
of position by (set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition, new_linenew_lineNewLineNewLineNewLinenew_line).
Attention
If the output text does not fit completely into the window, an exception is
raised. This can be avoided by
set_check('~text')set_check("~text")SetCheck("~text")SetCheck("~text")SetCheck("~text")set_check("~text").
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
WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Window handle.
RowRowRowRowrowrow (output_control) point.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Row index of text cursor position.
ColumnColumnColumnColumncolumncolumn (output_control) point.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Column index of text cursor position.
Result
get_tpositionget_tpositionGetTpositionGetTpositionGetTpositionget_tposition returns 2 (
H_MSG_TRUE)
if the window is valid. Otherwise
an exception is raised.
Possible Predecessors
open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window,
set_fontset_fontSetFontSetFontSetFontset_font
Possible Successors
set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition,
write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string,
read_stringread_stringReadStringReadStringReadStringread_string,
read_charread_charReadCharReadCharReadCharread_char
See also
new_linenew_lineNewLineNewLineNewLinenew_line,
read_stringread_stringReadStringReadStringReadStringread_string,
set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition,
write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string,
set_checkset_checkSetCheckSetCheckSetCheckset_check
Module
Foundation