Important Notice
The pages on this site contain documentation for very old MS-DOS software,
purely for historical purposes.
If you're looking for up-to-date documentation, particularly for programming,
you should not rely on the information found here, as it will be woefully
out of date.
KEY Statement (Event Trapping) Details
◄Summary► ◄Details► ◄Example► ◄Contents► ◄Index► ◄Back►
──────────────────────────────────────────────────────────────────────────────
KEY(n%) {ON | OFF | STOP}
Usage Notes
■ References to KEY statements when forms are showing generate an implicit
KEY OFF event. Use form- and control-specific events with forms.
See: ◄Object Events Summary►
■ To use the KEY statement with forms, you must first unload or hide any
visible forms. See: ◄HIDE Method► ◄UNLOAD Statement►
■ If your program contains event-handling statements and you are compiling
from the BC command line, use the /W or /V option. If you do not use
these options and your program contains event traps, Visual Basic
generates the error message, "ON event without /V or /W on command
line." See: ◄BC Command-Line Options►
■ KEY(n%) ON enables trapping of function keys, arrow keys, and user-
defined keys. If key n% is pressed after a KEY(n%) ON statement, the
routine specified in the ON KEY statement is executed.
■ KEY(n%) OFF disables trapping of key n%. No trapping takes place
until another KEY(n%) ON statement is executed. Events occurring while
trapping is off are ignored.
■ KEY(n%) STOP suspends trapping of key n%. No trapping takes place until
a KEY(n%) ON statement is executed. Any ON KEY events that occur while
trapping is suspended are remembered and processed when the next KEY(n%)
ON is executed. However, remembered events are lost if KEY(n%) OFF is
executed.
■ When a key event trap occurs (that is, the GOSUB is performed), an
automatic KEY STOP is executed so that recursive traps cannot take
place. The RETURN from a trapping routine automatically executes a
KEY ON statement unless an explicit KEY OFF was performed inside the
routine.
■ Visual Basic can also be used to trap shifted keys and other user-
defined events. See: ◄Declaring User-Defined Keys►