get_tpositionget_tpositionGetTpositionGetTposition (Operator)

Name

get_tpositionget_tpositionGetTpositionGetTposition — Position des Textcursors abfragen.

Signatur

get_tposition( : : WindowHandle : Row, Column)

get_tpositionget_tpositionGetTpositionGetTpositionGetTposition liefert die momentane Position des Textcursors im Ausgabefenster. Die Positionsangabe erfolgt im Bildkoordinatensystem. Die nächste Textausgabe auf dieses Fenster erfolgt ab der Cursorposition, wobei diese die linke Ecke der Schreiblinie des auszugebenden Strings (d.h. ohne Berücksichtigung von Unterlängen) bezeichnet. Die Cursorposition verändert sich bei der Ausgabe bzw. Eingabe von Text (write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString) und durch explizite Neupositionierung (set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, new_linenew_lineNewLineNewLineNewLine).

Achtung

Wenn der auszugebende Text nicht vollständig in das Fenster passt, wird ein Exception ausgelöst. Dies kann durch set_check('~text')set_check("~text")SetCheck("~text")SetCheck("~text")SetCheck("~text") unterdrückt werden.

Ausführungsinformationen

Multithreading-Typ: reentrant (läuft parallel zu nicht-exklusiven Operatoren).
Multithreading-Bereich: global (kann von jedem Thread aufgerufen werden).
Wird ohne Parallelisierung verarbeitet.

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control) window → (integer)

Fenster-Handle.

RowRowRowRowrow (output_control) point.y → (integer)

Zeilenindex der Textposition.

ColumnColumnColumnColumncolumn (output_control) point.x → (integer)

Spaltenindex der Textposition.

Ergebnis

get_tpositionget_tpositionGetTpositionGetTpositionGetTposition liefert den Wert 2 (H_MSG_TRUE), falls das Fenster gültig ist. Ansonsten wird eine Fehlerbehandlung durchgeführt.

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_fontset_fontSetFontSetFontSetFont

Nachfolger

set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, write_stringwrite_stringWriteStringWriteStringWriteString, read_stringread_stringReadStringReadStringReadString, read_charread_charReadCharReadCharReadChar

Siehe auch

new_linenew_lineNewLineNewLineNewLine, read_stringread_stringReadStringReadStringReadString, set_tpositionset_tpositionSetTpositionSetTpositionSetTposition, write_stringwrite_stringWriteStringWriteStringWriteString, set_checkset_checkSetCheckSetCheckSetCheck

Modul

Foundation

Operatoren