Appendix A: System Routines — Keyboard
639
TI
-
89 / TI
-
92 Plus Developer Guide
Not for Distribution
Beta Version January 26, 2001
GKeyIn
Declaration:
WORD
GKeyIn
(SCR_RECT *
rBlink
, WORD
Flags
)
Category(ies):
Keyboard
Description:
Wait for and return the next keypress (bypassing the event manager).
Inputs:
rBlink
— If not null, this is the rectangular region that defines the cursor
that will be “blinked” (by XORing a reverse/normal video
rectangle) while waiting on a key. If it is NULL then there is no
cursor.
Flags
— GKF_NORMAL — No special key processing.
GKF_MODAL
If the key pressed is a “modal” key (
®
,
O
,
¥
-
O
,
2
-
O
,
3
,
°
,
¯
,
K
, or any of the
built-in app keys:
"
,
%
, . . . ) then
N
is returned
and the key is repushed onto the keyboard buffer. Note
that DIALOG boxes usually set GKF_MODAL and
GKF_SYS so that if a user presses
°
in the dialog
box, the dialog box is closed and then the
°
key is
acted on (though there is a flag to allow
°
to be
activated on inside a dialog box).
GKF_SYS — Same as GKF_MODAL only for
“system” keys:
I
,
½
,
¿
,
¾
.
GKF_REPUSH_KEY — Whatever key is pressed, return it
and repush that key onto the
keyboard buffer.
GKF_NO_EVS — Ignore
½
key.
Outputs:
Keypressed.
Assumptions:
Apps should use the event manager to process keys.
GKeyIn
is only used
in special cases where the event manager is not accessible.
Side Effects:
By-passes the event manager’s handling of keys so this routine should be
used with caution.
Availability:
All versions of the TI
-
89 / TI
-
92 Plus.
(continued)
To Next Page
Loading...
Need help?
General
