read_charT_read_charReadCharReadCharread_char (Operator)
Name
read_charT_read_charReadCharReadCharread_char — Einlesen eines Zeichens aus einem Fenster.
Signatur
Beschreibung
read_charread_charReadCharReadCharread_char liest im Eingabefenster (= Ausgabefenster)
ein Zeichen von der Tastatur ein. Falls es sich um ein druckbares Zeichen
handelt, wird dieses in CharCharCharcharValchar 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_charReadCharReadCharread_char wurde abgebrochen (nicht immer möglich,
z.B. in nativen X11 Fenstern)
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 → HWindow, HTupleHHandleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)
Fenster-Handle.
CharCharCharcharValchar (output_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Eingelesenes Zeichen (falls kein Steuerzeichen).
CodeCodeCodecodecode (output_control) string → HTuplestrHTupleHtuple (string) (string) (HString) (char*)
Code für eingelesenes Zeichen.
Ergebnis
read_charread_charReadCharReadCharread_char 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
Alternativen
read_stringread_stringReadStringReadStringread_string,
fread_charfread_charFreadCharFreadCharfread_char,
fread_stringfread_stringFreadStringFreadStringfread_string
Siehe auch
write_stringwrite_stringWriteStringWriteStringwrite_string,
set_fontset_fontSetFontSetFontset_font
Modul
Foundation