Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Fileevnt_multi()
Event Library
evnt_keybd()                                                            AES

Syntax

WORD evnt_keybd( VOID )

Function       evnt_keybd() relinquishes program control to the operating
               system until a valid keypress is available in the
               applications' message pipe.

Opcode         20 (0x14)

Availability   All AES versions.

Parameters     None

Binding        return crys_if(0x14);

Return Value   evnt_keybd() returns a 16-bit value containing the ASCII
               code of the key entered in the lower eight bits and the
               scan code in the upper 8-bits.

Version Notes  TOS versions released at or above 2.06 and 3.06 disabled
               reception of keys 1 through 9 on the numeric keypad when
               used in conjunction with the alternate key. Users may now
               enter the full range of ASCII values by holding down alt,
               typing in the decimal ASCII code, and then releasing the
               alt key. These keys, therefore, should not be used by
               applications. The standard numeric keypad is still
               available.


See Also       evnt_multi()

Group          Event Library