Texas Instruments TI-89 - Ev_Defaulthandler

918
Appendix A: System Routines — Operating System
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
EV_defaultHandler
Declaration:
void
EV_defaultHandler
(Event *
event
)
Category(ies):
Operating System
Description:
Defines the default behavior of all events.
Your application interacts with the user by responding to events, primarily
CM_KEY_PRESS and CM_WPAINT events. But there are many more
event types (see section
9.3. Commands
) the majority of which your
application need not concern itself. Call
EV_defaultHandler
to deal with
any event messages your application does not explicitly handle.
Inputs:
event
— Pointer to event message from the OS.
Outputs:
None
Assumptions:
Most events are either acted upon by your application or passed to
EV_defaultHandler
for default behavior. Some events may need both app
processing and default processing. The CM_ACTIVATE event usually
requires such handling. When your application receives a CM_ACTIVATE
event, it usually calls
WinActivate
to activate its window, then calls
EV_defaultHandler
to get automatic menu activation. See section
9.4. Starting and Stopping an Application
for details.
Side Effects:
There can be any number of side effects depending on which event was
forwarded to
EV_defaultHandler
. See section
9.9. Default Event Handler
for default actions taken by each event type.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also:
Not applicable.
(continued)