![]() |
GKeyIn | Function (ROM Call 0x17E) |
kbd.h |
short GKeyIn (SCR_RECT *cursor_shape, unsigned short Flags); |
Gets character from the keyboard, with additional possibilities.
GKeyIn acts similarly to ngetchx, with following differences:
GKF_NORMAL | No special key processing.
This is the usual value to set.
Note: GKF_NORMAL is actually 0 (i.e. no flags are set). |
GKF_MODAL | If the pressed key is a modal
key (see QModeKey for information on
what is a "modal" key for the TIOS), GKeyIn will return
KEY_ESC instead of the real keystroke code,
and the keystroke will not be picked from the keyboard queue. If the pressed
key is not a mode key, GKeyIn behaves as usual.
Note that DIALOG boxes usually set GKF_MODAL and GKF_SYS so that if the user presses [VAR-LINK] in the dialog box, the dialog box is closed and then the [VAR-LINK] key is acted on (though there is a flag to allow [VAR-LINK] to be activated from inside a dialog box). |
GKF_REPUSH_KEY | GKeyIn will not pick the keystroke from the keyboard queue, so the "keypress" flag will remain set. You must explicitely pick it using ngetchx or flush the queue using GKeyFlush. |
GKF_ACCEPT | The purpose of this flag is unknown for the moment. |
GKF_SYS | If the pressed key is a system key (see QSysKey for information on what is a "system" key for the TIOS), GKeyIn will return KEY_ESC instead of the real keystroke code, and the keystroke will not be picked from the keyboard queue. If the pressed key is not a system key, GKeyIn behaves as usual. |
GKF_NO_EVS | Pressing the [CATALOG] key will be ignored. |