Ev_Errorcode - Texas Instruments TI-89 Developer's Manual

1224

EV_errorCode

Declaration: SINT EV_errorCode
Category(ies): Error Handling
Description: Setting this variable to an error number causes the OS to display the
corresponding error message dialog box when your app returns from
handling an event. Error numbers have names beginning with "ER_" in
tiams.h.
ER_throwVar is the preferred mechanism for signaling errors, but there
are some events during which your app must not throw an error. These
events are CM_START, CM_ACTIVATE, CM_FOCUS, CM_UNFOCUS,
CM_DEACTIVATE, CM_QUIT, CM_WPAINT, CM_INSTALL,
CM_UNINSTALL, CM_PACK, and CM_UNPACK. If your app gets into an
error state while processing one of these events, do whatever clean up you
can, store an error number in EV_errorCode, then return to the OS. See
section 10.2 Delayed Error Messages for additional details.
If an application stores error numbers in EV_errorCode several times
before returning to the OS, only the last stored value will be displayed as
an error message.
Inputs: Not applicable.
Outputs: Not applicable.
Assumptions: Access_AMS_Global_Variables must be defined.
Side Effects: Not applicable.
Availability: On AMS 2.00 and higher.
TI-89 / TI-92 Plus
Differences: None
See Also: ER_throwVar
Example:
EV_errorCode = ER_MEMORY;
TI-89 / TI-92 Plus Developer Guide
Appendix B: Global Variables — Error Handling
Not for Distribution Beta Version January 26, 2001