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_tpositionGetTpositionGetTpositionGetTpositionget_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_stringWriteStringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringReadStringread_string) und durch explizite Neupositionierung (set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition, new_linenew_lineNewLineNewLineNewLinenew_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")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

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandlewindow_handle (input_control) window → (handle)

Fenster-Handle.

RowRowRowRowrowrow (output_control) point.y → (integer)

Zeilenindex der Textposition.

ColumnColumnColumnColumncolumncolumn (output_control) point.x → (integer)

Spaltenindex der Textposition.

Ergebnis

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

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindowopen_window, set_fontset_fontSetFontSetFontSetFontset_font

Nachfolger

set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition, write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string, read_stringread_stringReadStringReadStringReadStringread_string, read_charread_charReadCharReadCharReadCharread_char

Siehe auch

new_linenew_lineNewLineNewLineNewLinenew_line, read_stringread_stringReadStringReadStringReadStringread_string, set_tpositionset_tpositionSetTpositionSetTpositionSetTpositionset_tposition, write_stringwrite_stringWriteStringWriteStringWriteStringwrite_string, set_checkset_checkSetCheckSetCheckSetCheckset_check

Modul

Foundation

Operatoren