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

read_charread_charReadCharread_charReadCharReadChar (Operator)

Name

read_charread_charReadCharread_charReadCharReadChar — Einlesen eines Zeichens aus einem Textfenster.

Signatur

read_char( : : WindowHandle : Char, Code)

Herror read_char(const Hlong WindowHandle, char* Char, char* Code)

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

Herror read_char(const HTuple& WindowHandle, char* Char, char* Code)

HTuple HWindow::ReadChar(HTuple* Code) const

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

HString HWindow::ReadChar(HString* Code) const

void HOperatorSetX.ReadChar(
[in] VARIANT WindowHandle, [out] VARIANT* Char, [out] VARIANT* Code)

BSTR HWindowX.ReadChar([out] BSTR* Code)

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

string HWindow.ReadChar(out string code)

Beschreibung

read_charread_charReadCharread_charReadCharReadChar liest im Eingabefenster (= Ausgabefenster) ein Zeichen von der Tastatur ein. Falls es sich um ein druckbares Zeichen handelt, wird dieses in CharCharCharCharCharcharVal zurückgegeben. Falls eine Steuertaste gedrückt wurde, ist dies am Wert von CodeCodeCodeCodeCodecode erkennbar. Einige wichtige Tasten sind dadurch identifizierbar. Mögliche Werte für CodeCodeCodeCodeCodecode 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

Achtung

Bei dem Fenster muss es sich um ein Textfenster handeln.

Parallelisierung

Parameter

WindowHandleWindowHandleWindowHandleWindowHandleWindowHandlewindowHandle (input_control)  window → HWindow, HTupleHTupleHTupleHWindowX, VARIANTHtuple (integer) (IntPtr) (Hlong) (Hlong) (Hlong) (Hlong)

Fenster-Handle.

CharCharCharCharCharcharVal (output_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Eingelesenes Zeichen (falls kein Steuerzeichen).

CodeCodeCodeCodeCodecode (output_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Code für eingelesenes Zeichen.

Ergebnis

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

Vorgänger

open_textwindowopen_textwindowOpenTextwindowopen_textwindowOpenTextwindowOpenTextwindow, set_fontset_fontSetFontset_fontSetFontSetFont

Alternativen

read_stringread_stringReadStringread_stringReadStringReadString, fread_charfread_charFreadCharfread_charFreadCharFreadChar, fread_stringfread_stringFreadStringfread_stringFreadStringFreadString

Siehe auch

write_stringwrite_stringWriteStringwrite_stringWriteStringWriteString, set_fontset_fontSetFontset_fontSetFontSetFont

Modul

Foundation

KlassenKlassenKlassenKlassen | | | | Operatoren
HALCON Operator-Referenz 12.0.2 Copyright © 1996-2016 MVTec Software GmbH