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.1  vex_butv                                                    TOS

 Name:         »Exchange button change vector« - Adapt the interrupt 
               vector for a mouse button press.

 Opcode:       125

 Syntax:       void vex_butv ( int16_t handle, int16_t (*pusrcode)(), 
               int16_t (**psavcode)() );

 Description:  The call vex_butv permits the installation of a custom 
               routine that is called by the VDI each time a mouse 
               button is pressed. The following apply:

                Parameter  Meaning

                handle     Workstation identifier
                pusrcode   Address of the new routine
                psavcode   Address of the old routine

               On entry to pusrcode, the mouse status is contained in 
               register d0 (in the same format as the button return 
               value in vq_mouse). The subroutine must save and 
               restore modified registers and call the old status 
               routine.

               Note: The input functions of the VDI work only on the 
               physical workstation, which is normally used by the 
               AES.

 Return value: The function does not return a result.

 Availability: Supported by all screen drivers.

 Group:        Input functions

 See Also:     Binding   vex_timv   vex_motv   vex_curv