get_tpositionget_tpositionGetTpositionget_tpositionGetTpositionGetTposition (Operator)

Name

get_tpositionget_tpositionGetTpositionget_tpositionGetTpositionGetTposition — Position des Textcursors abfragen.

Signatur

Beschreibung

get_tpositionget_tpositionGetTpositionget_tpositionGetTpositionGetTposition liefert die momentane Position des Textcursors im Ausgabefenster. Die Positionsangabe erfolgt im Koordinatensystem des Fensters, d.h. bei Textfenstern in Pixelkoordinaten. 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_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString) und durch explizite Neupositionierung (set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, new_linenew_lineNewLinenew_lineNewLineNewLine).

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")set_check("~text")SetCheck("~text")SetCheck("~text") unterdrückt werden.

Parallelisierung

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

Parameter

Ergebnis

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

Vorgänger

open_windowopen_windowOpenWindowopen_windowOpenWindowOpenWindow, open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow, set_fontset_fontSetFontset_fontSetFontSetFont

Nachfolger

set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, read_stringread_stringReadStringread_stringReadStringReadString, read_charread_charReadCharread_charReadCharReadChar

Siehe auch

new_linenew_lineNewLinenew_lineNewLineNewLine, read_stringread_stringReadStringread_stringReadStringReadString, set_tpositionset_tpositionSetTpositionset_tpositionSetTpositionSetTposition, write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, set_checkset_checkSetCheckset_checkSetCheckSetCheck

Modul

Foundation