get_tpositionT_get_tpositionGetTpositionGetTpositionget_tposition (Operator)

Name

get_tpositionT_get_tpositionGetTpositionGetTpositionget_tposition — Position des Textcursors abfragen.

Signatur

get_tposition( : : WindowHandle : Row, Column)

Beschreibung

get_tpositionget_tpositionGetTpositionGetTpositionget_tposition 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_stringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringread_string) und durch explizite Neupositionierung (set_tpositionset_tpositionSetTpositionSetTpositionset_tposition, new_linenew_lineNewLineNewLinenew_line).

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")set_check("~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

WindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Fenster-Handle.

RowRowRowrowrow (output_control) point.y → (integer)

Zeilenindex der Textposition.

ColumnColumnColumncolumncolumn (output_control) point.x → (integer)

Spaltenindex der Textposition.

Ergebnis

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

Vorgänger

open_windowopen_windowOpenWindowOpenWindowopen_window, set_fontset_fontSetFontSetFontset_font

Nachfolger

set_tpositionset_tpositionSetTpositionSetTpositionset_tposition, write_stringwrite_stringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringread_string, read_charread_charReadCharReadCharread_char

Siehe auch

new_linenew_lineNewLineNewLinenew_line, read_stringread_stringReadStringReadStringread_string, set_tpositionset_tpositionSetTpositionSetTpositionset_tposition, write_stringwrite_stringWriteStringWriteStringwrite_string, set_checkset_checkSetCheckSetCheckset_check

Modul

Foundation

Operatoren