get_tpositionT_get_tpositionGetTpositionGetTposition (Operator)
Name
get_tpositionT_get_tpositionGetTpositionGetTposition
— Position des Textcursors abfragen.
Signatur
Beschreibung
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 →
HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle.
RowRowRowRowrow
(output_control) point.y →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
Zeilenindex der Textposition.
ColumnColumnColumnColumncolumn
(output_control) point.x →
HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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