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:

Normally, Flags should be zero. It is collection of binary flags, where bits b0, b1, b3 and b4 are used. They are not very useful, but their meaning is as follows: Except in noted special cases, GKeyIn returns the same value as ngetchx. Menus and dialog boxes usually set b0=1 and b3=1, so that if au user presses say VAR-LINK key in the dialog box, the dialog box is closed and then the VAR-LINK key is acted on.

Note: Thomas Nussbaumer informed me that idle interferes with grayscale graphics. As GKeyIn calls the idle function, the use of GKeyIn while grayscale mode is active is not recommended.


Uses: ROM Call 0x3EA
Used by: GKeyFlush, cmd_showstat, cmd_toolbar, Dialog, DlgMessage, handleVarLinkKey, MenuKey, HelpKeys, GT_Trace


See also: ngetchx, kbhit, kbd_queue, OSFastArrows