CHAR Event (Listbox)
Description
Fired when the user presses a key while the ListBox has focus.
Syntax
bForward = CHAR( CtrlEntID, CtrlClassID, VirtCode, ScanCode, CtrlKey, ShiftKey, AltKey )
Parameters
Name | Description |
---|---|
CtrlEntID | Fully qualified name of the ListBox receiving the event. |
CtrlClassID | Type of control receiving the event. In this case "LISTBOX". |
VirtCode | Character that has been entered. This can be null if the keystroke generated a non-printable character such as an arrow key. |
ScanCode | If the keystroke generated a non-printable character this parameter contains the key-code. |
CtrlKey | Set to TRUE$ if the Ctrl key was pressed when the event was raised. |
ShiftKey | Set to TRUE$ if the Shift key was pressed when the event was raised. |
AltKey | Set to TRUE$ if the Alt-key was pressed when the event was raised. |
Returns
TRUE$ or FALSE$. If FALSE$, the program execution returns to the calling procedure. If TRUE$, the event processing goes to the next level. There is no system level CHAR event processing for a LISTBOX control.
Remarks
This event is raised as a result of the Windows WM_KEYDOWN and WM_CHAR notifications.
Equated constants for key codes can be found in the MSWIN_VIRTUALKEY_EQUATES insert record.
See Also
LISTBOX ACCEPTENTER property, LISTBOX EDITKEY property, LISTBOX ENTERASDBLCLK property, Common GUI NOECHO property.