Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.7.3  evnt_keybd                                                  TOS

 Name:         »Event keyboard« - Wait for a keyboard event

 Opcode:       20

 Syntax:       int16_t evnt_keybd ( void );

 Description:  The call evnt_keybd waits for a keyboard event, and 
               returns the corresponding code.

               Note: Keyboard events are always returned only to the 
               application that 'owns' the active window.

               With TOS versions from 2.06 and 3.06 onwards, this 
               function is disabled for keys [0] to [9] on the numeric 
               keypad when pressed together with the [Alternate] key. 
               These key combinations allow the entry of the complete 
               range of ASCII values (001 .. 255) by holding down the 
               [Alternate] key while typing in the decimal ASCII-code 
               on the numeric keypad. Without [Alternate] the numeric 
               keypad operates normally.

 Return value: The function returns in bits 0..7 the ASCII-code, and 
               in the bits 8..15 the scancode of the pressed key.

 Availability: All AES versions.

 Group:        Event library

 See Also:     Binding   evnt_multi   Messages