read_charT_read_charReadCharReadChar (Operator)

Name

read_charT_read_charReadCharReadChar — Einlesen eines Zeichens aus einem Textfenster.

Signatur

read_char( : : WindowHandle : Char, Code)

Beschreibung

read_charread_charReadCharReadCharReadChar liest im Eingabefenster (= Ausgabefenster) ein Zeichen von der Tastatur ein. Falls es sich um ein druckbares Zeichen handelt, wird dieses in CharCharCharCharcharVal zurückgegeben. Falls eine Steuertaste gedrückt wurde, ist dies am Wert von CodeCodeCodeCodecode erkennbar. Einige wichtige Tasten sind dadurch identifizierbar. Mögliche Werte für CodeCodeCodeCodecode sind:

'character':: druckbares Zeichen
'left':: Cursor links
'right':: Cursor rechts
'up':: Cursor oben
'down':: Cursor unten
'insert':: Einfügetaste
'none':: keine der angeführten Tasten
'cancelled':: read_charread_charReadCharReadCharReadChar wurde abgebrochen (nur unter Windows möglich)

Achtung

Bei dem Fenster muss es sich um ein Textfenster handeln.

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 → (handle)

Fenster-Handle.

CharCharCharCharcharVal (output_control) string → (string)

Eingelesenes Zeichen (falls kein Steuerzeichen).

CodeCodeCodeCodecode (output_control) string → (string)

Code für eingelesenes Zeichen.

Ergebnis

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

Vorgänger

open_windowopen_windowOpenWindowOpenWindowOpenWindow, set_fontset_fontSetFontSetFontSetFont

Alternativen

read_stringread_stringReadStringReadStringReadString, fread_charfread_charFreadCharFreadCharFreadChar, fread_stringfread_stringFreadStringFreadStringFreadString

Siehe auch

write_stringwrite_stringWriteStringWriteStringWriteString, set_fontset_fontSetFontSetFontSetFont

Modul

Foundation

Operatoren