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  Input functions                                               TOS

The input functions enable a program to inquire the status of the 
keyboard and mouse, taking into consideration the input modes. They 
also offer routines for linking in timer and mouse interrupts. The 
following functions are available:

 ∙ v_hide_c       Hides graphic mouse cursor
 ∙ v_show_c       Displays (unhides) graphic mouse cursor
 ∙ vex_butv       Moves service routine for mouse-button interrrupts
 ∙ vex_curv       Draws customized mouse pointer
 ∙ vex_motv       Moves service routine for mouse movement interrupts
 ∙ vex_timv       Moves service routine for timer interrupts
 ∙ vex_wheelv     Service routine for mouse wheel events
 ∙ vq_key_s       Inquires Shift-key status
 ∙ vq_mouse       Gets position of graphic cursor
 ∙ vrq_choice     Awaits keypress (REQUEST)
 ∙ vrq_locator    Gets position of graphic cursor (REQUEST)
 ∙ vrq_string     Reads in string from keyboard (REQUEST)
 ∙ vrq_valuator   Supervision of input devices (REQUEST)
 ∙ vsc_form       Defines graphic cursor
 ∙ vsin_mode      Switches between REQUEST and SAMPLE mode
 ∙ vsm_choice     Gets the key pressed last (SAMPLE)
 ∙ vsm_locator    Gets position of the graphic cursor (SAMPLE)
 ∙ vsm_string     Reads in string from keyboard (SAMPLE)
 ∙ vsm_valuator   Gets the status of input devices (SAMPLE)

Note: These functions are intended primarily for the owner of the 
physical workstation, i.e. for the AES. Programs should (provided 
there are no pressing needs for a different procedure) always inquire 
mouse and keyboard events through the AES's event functions, because 
otherwise inputs intended for other applications may be intercepted.

See Also: VDI workstations   Style guidelines