Texas Instruments TI-89 - Ev_Getc

920
Appendix A: System Routines — Operating System
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
EV_getc
Declaration:
USHORT
EV_getc
(UINT
indic
, Event *
event
)
Category(ies):
Operating System
Description:
Gets next character from keyboard. Puts the calculator into low power
mode until a character is available.
Inputs:
indic
— ST_IDLE or ST_PAUSE for the kind of busy indicator to display
on the status line while waiting for a keypress.
Outputs:
event
— Return event message containing either a CM_KEY_PRESS or
CM_CURSOR_FLASH command. The event contains the
keyboard modifier keys when the key was pressed.
Returns either a character number or zero (0) if the cursor blink timer timed
out.
Assumptions:
This routine will automatically power down the calculator if a key has not
been pressed after a few minutes.
Side Effects:
None
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
TI
-
89 / TI
-
92 Plus
Differences:
None
See Also:
Not applicable.
Example:
Event e;
USHORT ch;
/* Get a keypress from the keyboard */
while ((ch = EV_getc(ST_PAUSE, &e)) == 0)
;