User's Manual

6-19
Events
WDterm events occur when a specific condition is met. When an event is
"fired", an event handler function in your application is called.
Though the details of exactly how it is done varies from one programming
environment to the next, the source code skeletons for the various event handlers
are automatically generated and inserted into your source code for you. See the
samples for more specific information.
Each event passes relevant information to your event handler function. The only
event that does not pass any data is OnTermBaseRegister. All others pass at
least the Terminal ID on which the event occurred. OnTermData also passes the
data that was keyed or scanned into the terminal.
Terminal ID is always passed as 0-15. A Terminal ID value of 99 indicates an
error.
Once you have the event handler skeletons, you can proceed to add whatever
functionality you desire to each event.
You must call the OpenDevice method before any events can be fired.
OnTermBaseRegister
Event: An attached base station has successfully powered up and
communicated with the host computer via the serial
connection.
OnTermSignIn6
Data passed: terminal
Event: A six-line terminal has signed in. Terminal ID is passed in
terminal.
OnTermSignIn4
Data passed: terminal
Event: A four-line terminal has signed in. Terminal ID is passed
in terminal.
OnTermSignOut
Data passed: terminal
Event: A terminal has signed out. Terminal ID is passed in
terminal.
OnTermData
Data passed: terminal, data
Event: A terminal has sent data in response to an Input method call.
OnTermNotSignedIn
Data passed: terminal
Event: A command has been sent to a terminal that is not signed in.