read_charT_read_charReadCharReadChar (Operator)

Name

read_charT_read_charReadCharReadChar — Einlesen eines Zeichens aus einem Fenster.

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)

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 Fenster 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