====== CHAR event ======


 
==== Description ====
 
Occurs when a character is entered.
 
==== Syntax ====
 
//bforward// = **CHAR**(//ctrlentID//, //ctrlclassID//, //virtcode//, //scancode//, //ctrl//, //shift//, //alt//)
 
==== Parameters ====
 
CHAR accepts arguments for the following parameters.

^Parameter^Description^
|//CtrlentID//|Has the format //WindowName//.//ControlName//, where //WindowName// is the identifier of the window that contains the affected control, and //ControlName// is the identifier of the control. Notice that a period separates the two values.|
|//ctrlclassID//|The type of control that recognizes the event. Valid entries are:\\ \\ __Type__ - __Description__\\ COMBOBOX - Combo box.\\ EDITBOX - Edit box.\\ EDITFIELD - Edit line.\\ EDITTABLE - Edit table.\\ LISTBOX - List box.|
|//virtcode//|Virtual-key code (refer to Windows 3.1 SDK, WM_CHAR message, for more information).|
|//scancode//|Scan code (refer to Windows 3.1 SDK, WM_CHAR message, for more information).|
|//ctrl//|True (1), if the ctrl key is pressed. False (0), if the ctrl key is not pressed.|
|//shift//|True (1), if the shift key is pressed. False (0), if the shift key is not pressed.|
|//alt//|True (1), if the alt key is pressed. False (0), if the alt key is not pressed.|


 
==== Returns ====
 
True or false. If false, the program execution returns to the calling procedure. If true, the event processing goes to the next level.
 
==== See Also ====
 
[[echo|ECHO property]]
 
==== Remarks ====
 
Not all keystrokes generate a CHAR event. To execute an event for keys which do not generate the CHAR event, create menu items with the desired accelerators.

**Note:  **For forms that should not have menus, like dialogs, the menu items can be hidden and the accelerators will still work.
 
**
**