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-File7.7.27  vsm_choice                                                 TOS

 Name:         »Input choice, Sample mode« - Ascertain which function 
               key was pressed last.

 Opcode:       30

 Syntax:       int16_t vsm_choice ( int16_t handle, int16_t *choice );

 Description:  The call vsm_choice obtains the current value of the 
               'choice' device, normally the number of the last 
               pressed function key. The folowing apply:

                Parameter  Meaning

                handle     Workstation identifier
                choice     Pressed function key or 0, if none such was 
                           struck

               The number of function keys depends on the device in 
               each case. If another key has been activated, then the 
               associated code number will be returned.

 Return value: The function returns the selection status (0 = no key, 
               1 = key pressed).

 Availability: Although the function is implemented in ROM, it does 
               not seem to work properly. The function is not 
               supported by all device drivers. The input functions of 
               the VDI work only on the physical workstation, which is 
               normally used by the AES.

 Group:        Input functions

 See Also:     Binding   vrq_choice   vsin_mode