HALCON Website / HALCON Operator-Referenz / Graphik / Text
KlassenKlassen | | Operatoren

read_charT_read_charReadCharReadChar (Operator)

Name

read_charT_read_charReadCharReadChar — Einlesen eines Zeichens aus einem Textfenster.

Signatur

read_char( : : WindowHandle : Char, Code)

Herror T_read_char(const Htuple WindowHandle, Htuple* Char, Htuple* Code)

void ReadChar(const HTuple& WindowHandle, HTuple* Char, HTuple* Code)

HString HWindow::ReadChar(HString* Code) const

static void HOperatorSet.ReadChar(HTuple windowHandle, out HTuple charVal, out HTuple code)

string HWindow.ReadChar(out string 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

Parameter

WindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Fenster-Handle.

CharCharCharCharcharVal (output_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Eingelesenes Zeichen (falls kein Steuerzeichen).

CodeCodeCodeCodecode (output_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

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

KlassenKlassen | | Operatoren
HALCON Operator-Referenz 19.11.0.0 Copyright © 1996-2019 MVTec Software GmbH